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O'Reilly Media,Inc. 介 绍 


为 了 满足 读者 对 网 络 和 软件 技术 知识 的 迫切 需求 ， 世 界 著 名 计算 机 
图 书 出 版 机 构 O'Reilly Media, Inc. 授 权 机 械 工 业 出 版 社 ， 翻 译 出 版 一 批 该 
公司 久负盛名 的 英文 经 典 技术 专著 。 


O'Reilly Media, Inc. 是 世界 上 在 UNIX、X、Internet 和 其 他 开放 系统 
图 书 领 域 具有 领导 地 位 的 出 版 公司 ， 同 时 也 是 联机 出 版 的 先锋 。 





从 最 畅销 的 《The Whole Internet User's Guide & Catalog) ORAHA 
公共 图 书馆 评 为 20 世 纪 最 重要 的 50 本 书 之 一 ) 到 GNN (最 早 的 Internet 
门户 和 商业 网 站 ) ， 再 到 WebSite〈 第 一 个 桌面 PC 的 Web 服 务 器 软 
件 ) O'Reilly Media, Inc. 一 直 处 于 Internet 发 展 的 最 前 沿 。 





许多 书店 的 反馈 表明 ，O'Reilly Media, Inc. 是 最 稳定 的 计算 机 图 书 出 
版 商 一 每 一 本 书 都 一 版 再 版 。 与 大 多 数 计 算 机 图 书 出 版 商 相 比 ， 
O'Reilly Media, Inc. 具 有 深厚 的 计算 机 专业 背景 ， 这 使 得 OReilly Media, 
Inc. 形 成 了 一 个 非常 不 同 于 其 他 出 版 商 的 出 版 方针 。O'Reilly Media, Inc. 
所 有 的 编辑 人 员 以 前 都 是 程序 员 ， 或 者 是 顶尖 级 的 技术 专家 。O'Reilly 
Media, Inc. 还 有 许多 固定 的 作者 群体 一 他 们 本 身 是 相关 领域 的 技术 专 
家 、 咨 询 专 家 ， 而 现在 编写 著作 ，O'Reilly Media, Inc. 依 靠 他 们 及 时 地 推 
出 图 书 。 因 为 O'Reilly Media, Inc. 紧 密 地 与 计算 机 业界 联系 着 ， 所 以 




















O'Reilly Media, Inc. 知 道 市 场 上 真正 需要 什么 图 书 。 


译 者 序 


基本 上 所 有 应 用 程序 都 要 与 数据 打交道 ， 如 何 操纵 和 处 理 奔 层 数 据 
库 曾 经 是 一 个 让 人 非常 头痛 的 问题 ， 尤 其 对 于 Java 新 手 来 说 ， 更 是 无 从 
Pas 


如 有 果 直 接 使 用 最 底层 的 JDBC 来 访问 数据 库 ， 再 在 代码 中 夹杂 上 无 
数 的 SQL 语句 ， 以 这 样 的 方式 来 手工 编写 代码 不 仅 单调 乏味 、 易 于 出 
错 ， 而 且 会 占用 整个 应 用 程序 的 很 大 一 部 分 开发 工作 量 。 关 键 是 这 样 得 
到 的 最 终 产 品 往往 与 底层 的 数据 库 紧 密 地 耦合 在 一 起 ， 如 果 要 更 换 数据 
库 ， 必 须 花费 大 量 的 人 力 资 源 。 











优秀 的 面 癌 对 象 开发 人 员 厌 倦 了 这 种 重复 性 元 动 ， 他 们 开始 采用 通 
常 的 “积极 ”偷懒 做 法 ， 即 创建 工具 ， 使 整个 过 程 目 动 化 。 对 于 关系 数据 
库 来 说 ， 这 种 努力 的 最 大 成 果 束 是 对 象 /关系 映射 (ORM) CH, m 


Hibernate 则 是 这 些 工 具 中 的 典型 代表 。 








Hibernate 是 一 个 免费 的 开源 Java 包 ， 它 使 得 与 关系 数据 库 打交道 变 
得 十 分 轻松 ， 就 像 数 据 库 中 包含 的 是 普通 Java 对 象 一 样 ， 不 必 考 虑 如 何 
把 它们 从 神秘 的 数据 库 表 中 取出 《或 放 回 数据 库 表 中 ) 。Hibernate 解 放 
了 广大 Java 程 序 开 及 人 员 ， 使 他 们 可 以 专注 于 应 用 程序 的 对 象 和 功能 ， 
而 不 必 担 心 如 何 保存 它们 或 稍 后 如 何 找到 它们 。 





Hibernate 之 所 以 能 够 流行 ， 应 该 归功 于 以 下 优点 : 


1) Hibemate 是 JDBC 的 轻 量 级 对 象 封 装 ， 它 是 一 个 独立 的 对 象 持久 
层 框架 ， 与 App Server、EJB 没 有 什么 必然 的 联系 。Hibernate 可 以 用 在 任 
何 JDBC 可 以 使 用 的 场合 。 


2) Hibermate 是 一 个 和 JDBC 密 切 关 联 的 框架 ， 所 以 Hibernate 的 兼容 
性 与 DBC 了 驱动 、 数 据 库 都 有 一 定 的 关系 ， 但 是 与 使 用 它 的 Java 程 序 、 
底层 数据 库 没 有 任何 关系 ， 也 不 存在 兼容 性 问题 。 





3) Eclipse 等 主流 Java 集 成 开发 环境 对 Hibernate 有 很 好 的 文 持 ， 在 大 
型 项 目 ， 特 别 是 持久 层 关 系 映射 很 复杂 的 情况 下 ，Hibernate 效 率 非 常 
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为 了 让 以 前 对 Hibernate 了 解 不 多 的 Java 爱 好 者 快速 掌握 Hibernate 的 
基本 配置 、 使 用 方法 、 经 验 拉 巧 ， 以 及 它 与 其 他 常用 开发 工具 的 协同 配 
合 ， 本 书 的 作者 由 一 个 简单 而 现实 的 示例 入 手 ， 从 数据 表 的 创建 ， 讲 到 
各 种 基于 数据 库 的 操作 ， 甚 至 还 创建 了 一 个 简洁 的 Web 网 站 ， 内 容 涉及 
Hibernate 的 方方面面 。 讲 解 非 常 细致 ， 不 仅 包 括 了 足以 帮助 读者 理解 的 
源 代 码 ， 而 且 对 于 每 一 操作 步骤 ， 作 者 都 给 出 了 详细 的 操作 命令 。 相 信 
读者 在 阅读 和 实践 本 书 示例 的 过 程 中 一 定 不 会 遇 到 太 大 的 问题 ， 而 且 能 
够 以 最 短 的 时 间 来 掌握 Hibernate， 这 应 该 就 是 本 书 最 可 贵 的 价值 所 在 
Te 











ASE SERED ADA KGB © HBB op E229) 24 Hibernatet£ 28 A 3 
的 功能 ， 后 一 部 分 则 介绍 Hibernate 与 其 他 IDE 和 开发 工具 的 配合 使 用 。 
所 有 讲解 并 非 照 本 宣 科 式 地 照搬 API 文 要 和 参考 手册 ， 而 是 时 时 处 处 渗 
透 着 作者 在 使 用 Hibernate 过 程 中 所 领悟 到 的 经 验 和 体会 ， 尤 其 是 在 讲解 
Hibernate 的 关联 映 冉 配置 时 ， 虽 然 我 目 请 已 经 使 用 Hibernate 很 多 年 了 ， 
但 还 是 学 到 不 少 知识 点 ， 这 些 在 API 和 参考 手册 中 没有 遇 到 和 使 用 过 
第 二 部 分 中 介绍 的 各 种 开发 工具 也 是 成 熟 的 Java 开 有 人 员 不 可 或 缺 的 利 
器 ， 对 它们 的 掌握 和 理解 ， 是 超越 普通 程序 员 的 必 经 之 路 。 


在 翻译 过 程 中 ， 虽 然 我 力求 在 忠于 原文 的 基础 上 ， 尽 可 能 从 专业 
Java 开 发 人 员 的 角度 来 做 到 信 、 达 、 雅 ， 但 由 于 自身 水 平 有 限 ， 必 定 会 
有 诸多 人 不足， 希望 各 位 读者 不 童 指教 。 
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谢 我 的 家 人 ， 没 有 他 们 的 文 持 也 无 法 完成 这 本 书 的 翻译 。 








最 后 ， 祝 大 家 能 够 在 阅读 中 享受 技术 进步 市 来 的 乐趣 ! 
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2008 年 12 月 1 日 
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Hibernate 是 为 Java 设 计 的 轻 量 级 对 象 /关系 映射 Cobject/relational 
mapping) 服务 。 这 是 什么 意思 ? 这 就 是 说 ，Hibernate 可 以 让 你 用 普通 
的 Java 对 象 的 形式 来 简洁 而 有 效 地 处 理 关 系数 据 库 中 的 信息 。 不 过 ， 这 
样 的 说 明 仍 然 无 法 贴切 地 表达 这 项 技术 是 多 么 有 用 和 令 人 激动 。 持 有 这 
种 观点 的 人 并 非 只 是 我 一 个 : Hibernate 2.1 赢 得 了 《Software 
Development》 杂 志 第 14 届 “框架 库 和 组 件 ” 震 撼 大 奖 Colt Award) 。 

(本 书 是 《Hibernate: A Developer's Notebook) 的 后 续 更 新 版 本 ， 我 非 
第 汞 垃 地 编号 了 这 本 书 。 这 本 书 第 1 版本 介绍 的 是 Hibernate 2， 它 获得 了 


第 15 届 Jolt 技 术 类 图 书生 产 力 大 奖 〈Productivity Winner) 。 








MA, Hibernate RI TERE? 所 有 非凡 的 应 用 程序 “甚至 许 
多 平凡 的 应 用 程序 ) 都 需要 存储 和 使 用 各 种 信息 ， 也 就 都 会 涉及 关系 型 
数据 库 的 使 用 。 与 Java 对 象 世界 不 同 ， 数 据 库 通常 要 求 使 用 者 具备 一 定 
的 技巧 和 专业 知识 。 如 何 连通 这 两 个 世界 曾经 是 一 段 时 期 内 的 一 项 重要 
任务 ， 但 这 也 是 一 件 非 第 复杂 而 乏味 的 工作 。 


大 多 数 人 要 事先 写 出 一 些 非 常 繁琐 的 SQL 语句 ， 再 将 这 些 语句 作为 
字符 串 甬 入 到 Java 代 码 中 ， 接 着 再 使 用 JDBC (Java database 
connectivity) 执行 查询 语句 和 处 理 结 果 。JDBC 已 经 发 展 成 为 一 个 与 数 
据 库 通信 的 、 功 能 丰富 且 非 常 灵活 的 程序 库 ， 虽 然 现 在 基于 这 种 方法 还 





可 以 提供 一 些 简 化 和 改进 的 措施 ， 但 在 Java 中 使 用 JDBC 还 相当 繁琐 。 
对 于 大 量 的 数据 处 理 ， 我 们 需要 某 种 功能 更 强大 的 工具 ， 将 对 数据 库 的 
查询 从 代码 中 分 离 出 去 ， 并 以 面 问 对 象 的 方式 将 它们 组 件 化 ， 以 简化 对 
数据 库 的 操作 。 


多 年 来 ， 我 自己 开 肥 的 软件 中 就 使 用 了 这 样 的 轻 量 级 (甚至 是 超 轻 
量 级 ) 对 象 /关系 映射 层 功 能 组 件 。 该 组 件 最 初 起 源 于 我 的 同事 Eric 
Knapp 为 Lands' End 电 子 商 务 网 站 开发 的 Java 数 据 库 连 接 和 得 询 池 缓存 系 
统 。 这 个 系统 引入 了 外 部 SQL 模板 的 思想 ， 可 以 通过 名 称 来 访问 模板 ， 
并 有 效 地 与 运行 时 数据 组 合 起 来 ， 以 生成 实际 的 数据 库 碍 询 。 只 是 它 后 
来 才 文 持 在 模板 中 增加 一 些 简单 的 映射 指令 ， 将 这 些 模 板 直接 绑 定 到 
Java 对 象 。 











虽然 它 远 不 及 像 现 在 的 Hibernate 这 样 有 强大 的 功能 和 系统 ， 但 这 种 
方法 在 很 多 不 同 规模 的 项 目 和 各 种 环境 中 已 证 实 具 有 很 大 的 价值 。 直 到 
本 书 的 第 1 版 ， 我 们 一 直 都 在 使 用 这 种 方法 ， 在 为 Cisco 公 司 的 
CallManager 平 台 建 六 IP 电 话 应 用 程序 时 ， 我 们 最 后 采用 了 这 种 方法 。 不 
过 ， 现 在 再 做 新 项 目 时 ， 我 们 会 改 用 Hibernate。 在 学 习 完 本 书 以 后 ， 你 
会 明白 为 什么 要 做 这 样 的 选择 ， 而 且 也 可 能 会 做 出 同样 的 决定 。 
Hibernate 会 为 你 做 很 多 事情 ， 简 单 到 让 你 几乎 起 记 是 在 处 理 数据 库 。 需 
要 什么 对 象 ， 就 直接 拿 来 使 用 即 可 。 这 就 是 这 种 技术 的 优点 和 使 用 方 
Ke 








你 可 能 会 问 ，Hibernate 和 Enterprise JavaBeans (EJB) 有 什么 关系 ? 
它们 是 彼此 竞争 的 技术 吗 ? 在 什么 情况 下 应 该 使 用 哪 种 ? 事实 上 ， 你 可 
以 同时 使 用 这 两 种 技术 。 但 是 并 非 每 个 应 用 程序 都 需要 EJB 的 复杂 性 ， 
多 数 应 用 程序 只 需要 使 用 Hibernate 直 接 与 数据 库 交 互 ， 就 足够 了 。 另 一 
方面 ， 对 于 非常 复杂 的 三 层 (three-tier) 应 用 程序 环境 而 言 ，EJB 有 时 
是 不 可 或 缺 的 。 在 这 种 情况 下 ，EJB Session bean 可 以 使 用 Hibernate 来 持 
和 久保 存 数 据 ， 或 者 也 可 以 用 于 持久 化 BMP 实体 bean。 





事实 上 ，EJB 委 员 会 深 受 Hibemate 的 影响 ， 最 终 接受 了 Hibernate 
的 "plain old Java objects" (POJO) 的 方式 来 进行 持久 化 处 理 ， 这 是 一 种 
功能 强大 、 使 用 方便 的 持久 化 方式 ， 并 在 EJB 3 中 引入 J Java Persistence 
Architecture (JPA) (可 以 脱离 EJB 环 境 使 用 ) o Hibernate 3 其 实 也 以 一 
种 完全 可 移植 的 方式 实现 了 JPA 不过， 在 第 7 章 中 可 以 看 到 ， 你 可 能 仍 
旧 希 望 使 用 Hibernate 的 JPA 扩 展 ) 。 











Hibernate 的 开发 很 明显 已 经 成 为 Java 和 关系 型 数据 库 交 互 的 分 水 岭 
事件 。Java 界 应 该 感谢 Hibernate 之 父 Gavin King 和 他 的 团队 所 做 出 的 页 
献 ， 让 我 们 的 开发 更 加 简单 些 吧 。 这 本 书 就 是 要 帮助 你 尽快 地 掌握 这 项 
技术 。 


本 书 怎么 使 用 


本 书 最 初 是 O'Reilly 的 Developer's Notebook 系 列 的 一 部 分 ， 可 帮助 
读者 快速 掌握 有 用 的 最 新 技术 。 虽 然 本 书 扩展 了 很 多 Hibernate 用 户 可 能 
想 要 了 解 的 技术 ， 但 本 书 不 打算 成 为 Hibernate 的 完整 参考 手册 。 本 书 反 
映 了 作者 对 该 系统 研究 的 成 果 ， 从 最 初 的 下 载 ， 到 项 目的 配置 ， 通 过 一 
系列 项 目 演示 了 如 何 完成 各 种 实践 目标 。 








阅读 示例 并 实践 一 下 ， 你 不 但 能 够 快速 地 搭建 好 Hibernate 环 境 ， 并 
且 可 以 立即 将 它 用 于 实际 项 目的 开发 。 这 束 好 像 你 “跟着 我 " 走 过 我 绘制 
的 一 片 领地 ， 沿 途中 ， 我 会 指出 有 用 的 路 标 和 危险 的 陷阱 。 








虽然 我 一 定 会 介绍 一 些 背景 知识 ， 解 释 Hibernate 的 工作 原理 和 原 
因 ， 但 这 总 是 针对 某 项 任务 。 有 时 ， 我 会 建议 你 参阅 一 些 参考 文档 或 其 
他 在 线 资 源 ， 以 便 深入 了 解 一 些 后 层 的 概念 或 其 他 Hibernate 使 用 方式 的 
相关 细节 。 














在 读 过 前 面 几 间 之后， 就 不 需要 按照 划 市 顺序 依次 阅读 了 ， 可 以 直 
接 跳 转 到 你 特别 感 兴趣 或 关注 的 主题 。 你 可 以 目 己 构建 示例 代码 ， 也 可 
以 从 本 书 的 网 站 下 载 完整 的 源 代码 (可 以 在 前 一 章 示 例 代码 的 基础 上 ， 
按照 当前 章节 的 说 明 ， 自 己 动手 修改 代码 ， 来 实现 正在 阅读 的 代码 示 
BID 。 如 果 你 正在 学 习 的 示例 和 前 面 的 示例 有 关 ， 同 时 你 也 有 兴趣 了 








解 ， 则 可 以 随时 跳 转 到 先前 的 示例 。 


本 书 排版 字体 约定 


本 书 的 字体 有 特定 的 约定 ， 提 前 了 解 这 些 约 定 将 有 助 于 你 对 本 书 的 
理解 。 


斜体 〈Italic ) 


用 于 文件 名 、 文 件 扩展 名 、URL、 应 用 程序 名 称 、 强 调 以 及 第 一 次 
引入 的 新 术语 。 


464 (Constant width) 


用 于 Java 类 的 名 称 、 方 法 、 变 量 、 属 性 、 数 据 类 型 、 数 据 库 元 素 以 
及 以 文本 方式 出 现 的 代码 片段 。 


等 宽 黑 体 字 (Constant width bold) 


用 于 在 命令 行 输入 的 命令 ， 以 及 突出 演示 在 运行 示例 中 插入 的 新 代 
码 。 


等 宽 斜 体 字 (Constant width italic) 


用 于 说 明 输 出 结果 。 


本 书 网 站 


本 书 的 网 站 地 址 是 : 
http://www.oreilly.com/catalog/9780596517724/， 提 供 了 一 些 你 想 要 了 
的 重要 信息 。 本 书 所 有 示例 按 章 节 组 织 ， 都 可 以 在 以 上 网 站 中 找到 。 


发 


这 些 示 例文 件 已 经 压缩 成 ZIP 和 TAR 文件 。 


多 数 情况 下 ， 各 章 市 都 会 用 到 一 些 相同 的 文件 ， 随 看 示例 功能 的 不 
同 ， 这 些 文 件 不 断 增加 一 些 新 代码 。 下 载 文档 中 每 一 章 的 目录 都 是 相应 
示例 系统 的 状态 快照 (snapshot) ， 反 映 了 该 章 的 所 有 变动 和 新 增 内 


ia 


容 。 











如 何 联 系 我 们 


请 将 有 关 本 书 的 评论 和 问题 寄 送 给 出 版 商 : 





美国 : 


O'Reilly Media, Inc. 


1005 Gravenstein Highway North 


Sebastopol, CA 95472 


HA: 








北京 市 西城 区 西直门 南大 街 2 号 成 铬 大 厦 C 座 807 室 (100035) 奥 莱 
利 技术 咨询 〈 北 京 ) 有 限 公 司 





OReilly 的 每 一 本 书 都 有 专属 网 站 ， 你 可 以 在 那 找 到 关于 本 书 的 相 
关 人 信息， 包括 勘 误 表 、 示 例 代 码 以 及 其 他 的 信息 。 本 书 的 网 站 地 址 是 : 





http://www.oreilly.com/catalog/9780596517724/ 


询问 技术 问题 或 对 本 书 进行 评论 ， 请 发 电子 邮件 到 : 


bookquestions@oreilly.com 


欲 获取 有 关 我 们 的 图 书 、 会 议 、 资 源 中 心 (Resource Center) 以 及 
O'Reilly Network 的 更 多 信息 ， 可 以 访问 我 们 的 网 站 : 


http://www.oreilly.com 


http://www.oreilly.com.cn 
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[1] 一 部 成 功 的 美国 幼儿 电视 动画 片 。 


第 一 部 分 “Hibernate 快速 入 门 

我 们 的 第 一 个 目标 就 是 尽快 地 了 解 Hibernate 的 最 新 进展 。 这 一 部 分 
的 大 多 数 章 是 基于 《Hibernate: A Developer's Notebook) (O'Reilly) 的 
内 容 并 进行 了 更 新 ， 反 映 了 Hibermate 3 带 来 的 主要 变化 。 示 例 代 码 现在 
使 用 的 都 是 一 些 开发 工具 的 最 新 版 本 ， 我 们 通过 它们 来 提供 一 个 方便 而 
且 实 用 的 Hibernate 开 发 环境 。 还 有 一 章 专门 介绍 Java 5 的 标注 功能 ， 使 
用 标注 ， 而 不 是 用 XML 映射 文件 ， 也 可 以 配置 Hibernate 了 映射 。 





注意 : 当然 ， 和 其 他 任何 关于 活跃 的 开源 项 目的 图 书 一 样 ， 图 书 介 
绍 的 内 容 总 赶不上 开源 项 目的 发 展 ! 附录 E 列 出 了 本 书 讨 论 的 工具 的 特 
定 版 本 以 及 应 对 变化 的 指导 思想 。 


因为 我 们 采用 Maven 来 帮助 下 载 许多 工具 和 库 ， 所 以 使 用 这 本 书 来 
独 手 学 习 和 实践 书 中 的 代码 示例 会 更 加 容易 。 因 为 我 们 希望 你 可 以 明 
白 ， 没 有 什么 理由 不 去 亲自 实践 一 下 这 些 代码 示例 。 


EAZ 了 Hibernate 的 基础 之 后 ， 第 二 部 分 将 演示 如 何 将 Hibernate 绑 
定 到 其 他 组 件 环境 ， 让 各 种 组 件 互相 配合 ， 以 发 挥 更 大 的 作用 。 








万 变 不 离 其 守 ， 现 在 就 开始 学 习 吧 。 


第 1 革 ”安装 和 设置 





我 一 直 很 惊讶， 竟然 会 有 这 么 多 免费 而 又 好 用 的 开源 Java 工 具 。 多 
年 前 ， 我 开发 一 个 JSP 的 电子 商务 项 目 时 ， 需 要 一 个 轻 量 级 对 象 /关系 数 
据 库 映射 服务 ， 那 时 还 没有 Hibernate 这 样 的 工具 ， 只 能 自己 构建 了 一 个 
这 样 的 组 件 。 这 个 组 件 经 过 几 年 的 发 展 ， 开 发 出 一 些 很 酷 、 很 独特 的 功 
能 。 但 是 在 我 发 现 了 Hibernate 以 后 ， 我 想 在 下 一 个 项 目 中 ， 就 不 会 再 继 
续 使 用 自己 熟悉 的 那个 系统 了 我 当然 对 自己 的 系统 抱 有 偏爱 ) ， 而 是 
会 使 用 Hibernate。 用 过 之 后 ， 你 一 定 会 知道 Hibernate 有 多 棱 ! 





正在 读 这 本 书 的 你 ， 一 定 急于 想 知 道 这 种 功能 强大 而 且 使 用 方便 的 
技术 ， 是 如 何 架 起 连接 Java 对 象 和 关系 数据 库 这 两 个 世界 之 间 的 桥梁 
的 ! Hibernate 很 好 地 充当 了 这 个 角色 ， 它 并 不 很 复杂 ， 所 以 学 习 起 来 也 
不 困难 。 为 了 展示 这 一 点 ， 本 章 将 要 指导 你 理解 Hibernate 的 用 法 ， 让 你 
看 看 为 什么 Hibernate 会 这 么 令 人 激动 。 


之 后 的 章节 将 介绍 在 更 复杂 环境 〈 例 如 Spring 和 Stripes) 下 ， 把 
Hibernate 作 为 它们 的 组 成 部 分 的 应 用 ， 以 及 它 和 其 他 数据 库 的 配合 使 
用 。 第 1 章 的 目标 是 要 问 你 展示 ， 使 用 Hibernate 构 建 一 个 基本 的 、 目 我 
包含 的 环境 ， 并 且 用 它 完 成 真正 的 操作 是 多 么 容易 的 。 











获得 Ant 及 布 版 本 


可 能 有 些 令 人 意外 ， 在 运行 Hibernate 之 前 需要 做 几 件 与 Hibernate 本 
身 无 关 的 事 。 首 先 ， 你 必须 搭建 一 个 开发 环境 ， 以 供 示 例 代 码 可 以 运 

也 可 以 为 你 可 能 构建 的 任何 实际 项 目 莫 定 坚 实 的 基础 ， 这 将 是 令 人 
高 兴 的 意外 收获 。 








如 琳 在 你 的 Java 项 目 中 ， 还 没有 使 用 Ant 去 管理 构建 (build〉、 测 
i (test) 、 运 行 (run) 以 及 打包 (package) 的 工作 ， 现 在 就 是 开始 使 
用 Ant 的 好 时 机 。 本 书 的 示例 都 是 Ant 驱 动 的 ， 所 以 ， 你 得 安装 一 个 能 用 
的 Ant 才 能 运行 示例 代码 ， 并 验证 在 系统 中 对 代码 做 出 的 修改 ， 这 才 是 
最 佳 的 学 习 方 式 。 


首先 ， 获 得 Ant 的 二 进 制 发 布 版 本 ， 并 安装 它 。 


为 何在 意 


我 们 选择 使 用 Apache Ant 来 处 理 示例 有 几 个 原因 。Ant 很 方便 ， 而 
且 功 能 强大 ， 它 已 经 成 为 基于 Java 开 发 的 标准 构建 工具 ， 而 且 是 免费 、 
跨 平 台 的 工具 。 如 果 使 用 Ant， 我 们 的 示例 将 可 以 在 任何 Java 环 境 中 一 
样 地 正常 运行 ， 也 就 是 说 ， 本 书 的 任何 读者 都 不 会 因为 运行 示例 而 遇 到 
麻烦 。 这 也 意味 着 ， 我 们 可 以 少 花 一 点 力气 就 能 够 做 很 多 很 酷 的 事情 ， 





尤其 是 几 个 Hibernate 工 具 特 意 支持 Ant 之 后 ， 更 是 如 此 。 我 们 会 教 你 如 
何 利用 这 些 工具 《值得 注意 的 是 ， 最 近 更 复杂 的 Java 项 目 经 名 使 用 的 是 
Maven (H) ， 它 增加 了 很 多 其 他 的 项 目 管 理 功 能 。 所 以 我 必须 从 二 者 
中 挑选 一 个 ， 本 着 尺 可 能 简单 和 实用 的 原则 ， 我 就 决定 继续 使 用 Ant 来 
管理 这 些 示例 ) 。 如 果 你 目前 正在 使 用 Maven 作 为 代码 构建 工具 ， 你 会 
注意 到 我 们 使 用 Maven 的 Ant 任 务 (Task) 来 管理 Ant 构 建 的 依赖 关系 。 
虽然 Maven 的 发 展 势头 强劲 ， 但 Ant 仍 然 是 目前 Java 开 发 中 使 用 最 广泛 的 
构建 工具 。 每 一 章 的 示例 代码 文件 夹 中 也 包含 一 个 Maven 的 pom.xml 文 
件 ， 可 以 用 Maven 进 行 编译 。 在 许多 情况 下 ， 使 用 Maven Hibernate3 插 
件 ，Maven 构 建文 件 提供 的 功能 与 Ant 的 build.xml 文 件 一 样 。 第 12 章 介绍 
了 如 何 用 完整 的 Maven 来 构建 和 部 署 Hibernate 应 用 程序 的 方法 ， 但 本 书 
大 部 分 示例 仍旧 使 用 Ant 作 为 构建 工具 ， 同 时 使 用 Maven Ant Task 来 查 
找 和 下 载 需要 的 各 种 库 文 件 ， 包 括 库 文 件 之 间 互 相信 赖 的 文件 。 























能 够 使 用 这 些 功 能 ， 需 要 做 的 第 一 件 事 就 是 先 安 装 Ant， 让 和 





注意 : 我 以 前 觉得 奇怪 ， 可 以 用 Make， 为 什么 还 要 用 Ant? ME, 
我 已 经 明白 用 Ant 来 管理 Java 的 代码 构建 有 多 么 美妙 ， 没 有 Ant 还 真 的 不 


Ant 的 二 进 制 发 布 包 可 以 在 http://ant.apache.org/bindownload.cgi 下 
载 。 演 动 网 页 ， 找 到 Ant 的 当前 最 新 版 本 ， 然 后 下 载 适合 的 压缩 文件 格 
式 。 选 择 一 个 适合 存放 的 位 置 保存 文件 ， 然 后 解压 。 压 缩 文 件 展开 的 目 
录 束 是 ANT_HOME。 假 如 你 把 压缩 文件 解压 到 目录 /usr/local/apache-ant- 
1.7.0， 你 可 能 会 想 创建 一 个 符号 链接 (symbolic link) 以 方便 使 用 ， 同 
时 当 你 升级 到 新 版 本 时 ， 也 可 以 免 去 更 新 环境 配置 的 麻烦 : 





/usr/local%ln-s apache-ant-1.7.0 ant 





安装 好 Ant 之 后 ， 需 要 做 一 些 设置 才能 让 它 正常 工作 。 你 得 将 Ant 的 
bin 目 录 ( 在 这 个 例子 中 ， 就 是 /usr/local/ant/bin) 添加 到 命令 路 径 中 。 还 
需要 设置 环境 变量 ANT_HOME， 将 其 设 定 为 安装 Ant 的 最 顶级 目录 (在 
这 个 例子 中 ， 就 是 /usr/local/ant) 。 至 于 如 何在 不 同 的 操作 系统 中 执行 
以 上 这 些 处 理 步 又 ， 如 果 需 要 的 话 ， 可 以 参阅 Ant 的 手册 





(http://ant.apache.org/manual/) 。 


[1] http://maven.apache.org/. 


检查 Java 版 本 


当然 ， 我 们 假定 你 已 经 安装 好 了 Java software development 

kit (SDK) 。 目 前 你 应 该 使 用 Java 5 或 更 新 的 版 本 ， 因 为 新 版 本 的 SDK 
会 提供 一 些 有 用 的 新 功能 。 尽 可 能 使 用 最 新 稳定 版 本 的 SDK, Java 5 或 
Java 6 都 可 以 支持 本 书 的 所 有 示例 。 用 Java 1.3 也 可 以 使 用 Hibernate2 的 
大 部 分 功能 ， 但 你 得 用 1.3 版 本 的 Java 编 译 器 重新 构建 Hibernate JAR 文 
件 。 发 布 版 本 越 新 ， 对 Java 版 本 的 要 求 就 越 高 ， 而 且 Java 5 已 经 发 布 很 
长 时 间 了 ， 它 本 里 就 提供 了 很 多 优点 ， 所 以 我 们 没有 必要 为 兼容 早期 的 
JDK 而 花费 时 间 。 我 们 的 示例 都 假定 你 用 的 至 少 是 Java 5， 如 果 使 用 更 
低 版 本 的 JDK， 那 么 就 得 做 大 量 修改 调整 。 运 行 以 下 命令 可 以 查看 JDK 
版 本 : 











$java-version 

java Version"1.6.0 02" 

Java (TM) SE Runtime Environment (build 1.6.0 02-b06) 

Java HotSpot (TM) Client VM (build 1.6.0 02-b06, mixed mode, 
sharing) 








你 也 应 该 使 用 官方 发 布 的 Java 版 本 (例如 Sun 或 Apple 友 布 的 版 
AS) 。 在 编写 本 书 时 ， 我 们 的 技术 审阅 者 发现 GNU 公 共 授权 的 “功能 类 
似 ” 的 Java 实 现 并 不 能 正确 运行 这 些 工具 和 示例 代码 。 许 多 Linux 发 布 版 
本 安装 的 默认 Java 环 境 就 是 GNU 的 。 如 果 你 正在 使 用 Linux， 可 能 需要 





自己 下 载 Sun 的 JDK， 并 确保 使 用 的 是 正确 的 版 本 《通过 运行 java- 
version 命 令 ) 。 既 然 Sun 已 经 开放 了 Java 的 源 代 码 ， 和 希望 将 来 这 种 情况 
会 得 到 改善 ， 到 时 候 可 能 在 任何 目 由 软件 版 本 中 都 会 目 珊 Sun JRE 和 
JDK。 不 过 ， 在 那 一 天 实现 以 前 ， 你 必须 目 己 下 载 。 





在 编写 本 书 时 ， 基 于 Debian 的 发 布 版 本 可 以 用 它们 的 安装 管理 工具 
来 安装 Sun JDK (Ubuntu 的 "Feisty Fawn" 和 "Gutsy Gibbon" 发 行 版 本 就 自 
带 了 JDK 5 和 6) 。Red Hat 系 列 的 发 布 版 本 仍然 需要 直接 从 Sun 
Microsystems 的 网 站 下 载 Java。 具 体 情 况 具体 分 析 吧 。 


安装 好 以 后 ， 就 应 该 能 够 启动 Ant 进 行 测试 ， 来 确认 一 切 都 没有 问 


Sant-version 
Apache Ant version 1.7.0 compiled on December 13 2006 


me PaaS 











咽 ， 目 前 还 不 多 ， 不 过 现在 已 经 可 以 尝试 我 们 稍 后 将 要 提供 的 示例 
了 ， 再 以 这 些 示例 作为 起 点 ， 去 做 实际 的 Hibernate 项 目 。 


如 果 你 是 Ant 新 手 ， 最 好 先 简单 阅读 一 下 它 的 手册 来 了 解 Ant 的 工作 
原理 和 功能 。 这 样 可 以 让 你 了 解 示例 中 用 到 的 build.xml 文 件 是 怎么 回 
事 。 如 果 你 开始 或 已 经 喜欢 上 了 Ant， 想 深入 研究 ， 那 么 你 可 以 仔细 阅 


读 它 的 手册 Cl) ， 或 阅读 OReily 的 《Ant:， The Definitive Guide) 
《当然 ， 应 该 先 把 这 本 书 看 完 ) 。 


其 他 


Eclipse (|!) 、JBuilder (1) , NetBeans!“ ， 还 是 其 他 Java 
IDE? 嗯 ， 你 当然 可 以 使 用 这 些 IDE， 但 是 怎么 把 Ant 整 合 到 IDE 的 构建 
过 程 中 ， 就 是 你 自己 的 事 了 《有 好 几 种 IDE 已 经 支持 Ant， 所 以 你 可 能 
经 走 在 前 面 了 ;对 于 其 他 IDE， 你 可 能 还 需要 跨越 学 习 的 障碍 ) 。 如 果 
都 行 不 通 ， 你 还 可 以 使 用 IDE 开 发 自己 的 程序 代码 ， 然 后 使 用 我 们 提供 
的 一 个 build 脚本 ， 从 命令 行 来 调用 Ant。 








如 果 你 使 用 的 是 Maven， 则 可 以 通过 在 任意 一 章 的 示例 目录 或 最 项 
级 的 examples 目 录 中 执行 mvn eclipse: eclipse， 来 生成 Eclipse IDEM H 
文件 。 如 果 在 examples 目 录 中 运行 mvn eclipse: eclipse, Maven 将 为 每 一 
章 的 示例 生成 一 个 Edipse 项 目 。 第 12 章 将 详细 介绍 如 何 用 Maven 来 构建 


示例 代码 ， 第 11 章 将 详细 介绍 Hibernate 的 Eclipse 工具 的 用 法 。 


[1] http://ant.apache.org/manual/. 
[2] http://www.eclipse.org/. 
[3] http://www.borland.com/jbuilder/. 


[4] http://www.netbeans.org/. 


SH 
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稍 等 一 下 ， 难 道 我 还 没有 讲 完 用 Ant 构 建 本 书 示 例 项 目的 用 法 ? 确 
实 还 没有 说 完 ， 不 过 ， 这 也 并 不 是 全 部 。 虽 然 本 书 以 Ant 作 为 示例 构建 
的 基础 ， 我 们 决定 本 书 应 该 通过 Maven Tasks for Ant 来 演示 一 下 Maven 
RAKA (dependency) 管理 功能 。 本 书 的 最 初版 本 在 这 一 部 分 只 用 
了 几 页 的 篇 幅 来 介绍 如 何 下 载 和 管理 一 系列 第 三 方 库 ， 包括 从 Jakarta 
Commons Lang 到 CGLIB。 如 果 这 些 工 作 由 你 亲自 来 做 ， 最 少 也 得 花费 
你 宝贵 的 几 分 钟 的 时 间 ， 而 且说 明 如 何 操作 和 操作 本 身 费 事 又 繁琐 。 本 
书 中 ， 我 们 在 puild.xml 文 件 中 声明 了 项 目 需要 依赖 的 库 文 件 ， 并 由 
Maven 负 责 下 载 和 管理 这 些 依 赖 文 件 。 这 样 就 节省 了 许多 步骤 和 时 间 。 
好 ， 现 在 就 开始 安装 Maven Tasks for Ant. 





应 该 怎么 做 





有 两 种 方法 来 整合 Maven Tasks for Ant: 第 一 种 方法 是 将 需要 的 
JAR 文 件 放 在 Ant 的 lib 目 录 ， 第 二 种 方法 就 是 在 Ant 的 构建 build) 文件 
中 用 typedef 声 明 来 包括 antlib 定 义 。 我 们 打算 使 用 前 一 种 方法 ， 将 
maven-ant-tasks-2.0.8.jar 文 件 添 加 到 Ant 的 lib 目 录 中 ， 因 为 这 样 对 示例 的 
build.xml 文 件 修 改 量 最 少 。 首 先 ， 从 Maven 的 网 站 趾 下 载 需 要 的 JAR 文 
件 ， 在 它 的 首页 上 应 该 可 以 看 到 用 于 下 载 Maven Tasks for Ant 的 链接 





(如 图 1-1 所 示 ) o 
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图 1-1 Maven H 34 Maven Tasks for Ant 的 下 载 链接 


在 编写 本 书 时 ，Maven Tasks for Ant 的 版 本 是 2.0.8。 点 击 Maven 
Tasks for Ant 2.0.8 的 链接 ， 选 择 一 个 镜像 ， 就 可 以 下 载 到 一 个 名 为 
maven-ant-tasks-2.0.8.jar 的 文件 。 将 该 文件 保存 到 本 地 目录 。 


[1] http://maven.apache.org/. 


安装 Maven Tasks for Ant 


接 下 来 ， 将 下 载 好 的 maven-ant-tasks-2.0.8.jar 文 件 复制 到 
ANT_HOMRE/lib 目 录 中 。 如 果 你 从 头 至 尾 按 本 章 的 说 明 来 操作 ， 现 在 应 
该 已 经 下 载 并 安装 好 了 Ant。 还 应 该 设置 一 个 名 为 ANT_HOME 的 环境 变 
量 ， 当 然 ， 你 也 要 了 解 Ant 的 安装 目录 是 什么 。 在 将 maven-antrtasks- 
2.0.8.jar 复 制 到 ANT_HOME/lib 目 录 以 后 ， 任 何 build.xml 文 件 都 可 以 包含 
相应 的 命名 空间 (namespace) ， 以 使 用 Maven Tasks for Ant. 





如 果 你 运行 示例 使 用 的 计算 机 上 有 多 个 用 户 ， 而 且 你 没有 将 JAR 文 
件 放 到 ANT_HOME/ib 目 录 的 管理 权限 ， 不 必 担 心 ， 你 也 可 以 将 maven- 
ant-tasks-2.0.8.jar 文 件 放 在 一 /anUlib 这 个 目录 中 。Ant 也 会 自动 在 这 
录 中 但 找 任 何 JAR 文 件 。 


在 将 maven-ant-tasks-2.0.8.jar 文 件 复制 到 ANT_HOME/ib 目 录 以 后 ， 
你 应 该 能 够 运行 以 下 命令 ， 以 检查 当前 UNIX 的 类 路 径 〈class path) 中 


是 否 包 含 了 maven-ant-tasks-2.0.8.jar: 





Sant-diagnostics|grep maven|grep bytes 
maven-ant-tasks-2. 0.8.jar (960232 bytes) 





在 Windows 中 ， 运 行 ant-diagnostics， 并 检查 输出 的 类 路 径 包 括 的 类 
库 列表 中 是 否 包 含 了 maven-ant-tasks-2.0.8.jar。 





使 用 HSQLDB 数 据 库 引 擎 








Hibernate 文 持 非 常 多 的 关系 数据 库 ， 可 能 对 于 下 一 个 项 目 中 你 打算 
使 用 的 关系 数据 库 ，Hibernate 就 已 经 提供 了 支持 。 我 们 需要 为 示例 挑选 
一 个 数据 库 ， 季 运 的 是 ， 眼 前 就 有 一 个 好 的 选择 。 这 是 一 个 免费 的 、 纯 
Java 的 开源 自由 软件 项 目 ， 它 功能 强大 ， 足 以 担当 我 们 的 商业 软件 项 目 
中 的 数据 存储 支持 系统 。 令 人 惊讶 的 是 ，HSQLDB 也 相当 完善 而 且 安 装 
简单 (简单 到 我 们 可 以 让 Maven 在 新 版 中 负责 它 的 安装 ) ， 所 以 在 此 讨 
论 它 很 恰当 (你 是 否 听 说 过 Hypersonic-SQL， 现 在 叫做 HSQLDB。 
Hibernate 的 很 多 说 明文 档 还 沿用 旧 的 名 称 ) 。 








如 果 你 偶然 访问 http://hsql.sourceforge.net/， 发 现 这 个 项 目 好 像 已 经 
停止 了 ， 不 要 惊 慨 。 这 是 错误 的 网 址 ， 它 是 HSQLDB 项 目的 前 身 。 图 1- 
2 演示 了 该 项 目 当前 的 主页 ， 它 还 相当 活跃 。 


为 何在 意 





本 书 示 例 是 基于 数据 库 的 ， 每 个 人 都 可 以 下 载 这 些 示 例 ， 方 便 地 在 
此 基础 上 做 试验 ， 其 间 不 需要 转换 任何 SQL 方言 dialect) 或 操作 系统 
命令 ， 就 可 以 和 你 的 数据 库 一 起 使 用 也许 这 意味 着 你 可 以 节省 下 一 两 
天 的 时 间 ， 不 用 去 研究 怎么 下 载 、 安 装 和 配置 蘑 种 常用 数据 库 环 境 ) 。 


最 后 ， 如 采 你 是 HSQLDB 新 手 ， 那 么 在 用 过 之 后 感到 印象 深刻 和 好 奇 心 
十 足 的 概率 肯定 很 高 ， 最 终 在 你 自己 的 项 目 中 会 选择 使 用 这 种 数据 库 ， 
正如 其 项 目 主页 上 所 说 的 : 











HSQLDB 是 用 Java 编 写 的 领先 的 SQL 关系 数据 库 引 擎 。 它 提供 了 一 
个 JDBC 驱 动 程序 ， 支 持 ANSI-92 SQL 的 一 个 丰富 子 集 CBNF 树 格式 ) ， 
以 及 SQL 99 和 2003 增 强 (enhancement) 。 它 提供 了 一 个 小 巧 (Applet 版 
本 的 体积 小 于 100kB ) 而 快速 的 数据 库 引 擎 ， 以 及 基于 内 存 和 磁盘 的 两 
种 数据 表 ， 支 持 谍 入 式 和 服务 器 模式 。 此 外 ， 还 包括 了 一 些 工具 ， 例 如 
微型 web 服务 器 、 内 存 查 询 Cin-memory query) 和 管理 工具 〈 能 够 作为 
Applet 运 行 ) ， 以 及 很 多 演示 例子 。 








应 该 怎么 做 


当 构 建 本 书 的 示例 时 ，Maven Ant Tasks 将 自动 从 位 于 
http:/repol.maven.org/maven2/ 的 Maven 仓 库 (repository) 下 载 HSQLDB 
JAR《〈 以 及 其 他 需要 的 JAR) 。 上 所 以 ， 如 果 你 想 马 上 体验 一 下 ， 可 以 直 
接 转 到 1.7 节 。 和 否则 ， 如 果 你 想 下 载 HSQLDB 供 自己 使 用 ， 或 者 想 查 阅 
它 的 文档 、 在 线 论坛 或 邮件 列表 ， 就 可 以 访问 它 的 项 目 主 页 
http://hsqldb.org/。 点 击 下 载 当 前 最 新 稳定 版 本 (latest stable version) 的 
链接 〈 在 编写 本 书 时 ， 最 新 的 版 本 是 1.8.0.7， 如 图 1-2 所 示 ) 。 这 将 打开 
一 个 典型 的 SourceForge 下 载 页 面 ， 上 面 列 出 了 当前 选中 的 版 本 可 以 提供 











的 下 载 链接 。 选 择 一 个 合适 的 镜像 站 点 ， 就 可 以 开始 下 载 ZIP 文 件 。 


JER: 去 吧 ， 下 载 HSQLDB。 哎 呀 ， 它 们 的 个 头 都 很 小 ! 


~ 
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Lightweight 100% Java SQL Database Engine 


downloads: 
The new HSQLDB 


è Latest stable 


version: 1.8.0.7 


HSQLDB 1.8.0 final is out. A year of soli 


图 1-2 HSQLDB 主 页 上 最 新 的 稳定 版 本 的 链接 


Hibernate 对 其 他 数据 库 的 支持 怎么 样 呢 ?不 用 担心 ，Hibernate 现 在 
可 以 支持 MySQL、PostgreSQL、Oracle、DB2、Sybase、Informix、 
Apache Derby 等 各 种 数据 库 ( 本 书 将 在 第 10 章 和 附录 C 中 教 你 如 何 为 不 
同 的 数据 库 指定 各 自 的 “方言 ”(dialects))〉 。 不 过 ， 如 果 你 真 的 需要 ， 
可 以 斌 着 从 一 开始 就 去 搞 清楚 怎么 和 你 最 喜欢 的 数据 库 打 交道 。 这 也 意 





味 着 你 在 跟着 本 书 示 例 走 时 多 花费 一 些 额 外 工夫 ， 同 时 也 会 错过 发 现 
HSQLDB 美 妙 之 处 的 大 好 机 会 。 
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不 需要 再 讲 什么 激励 的 话 吧 ! 你 选择 这 本 书 的 目的 就 是 想 学 习 如 何 
使 用 Hibernate。 或 许 并 不 太 令 人 感到 意外 ，Hibernate 中 为 应 用 程序 提供 
对 象 /关系 映射 服务 的 核心 部 分 称 为 Hibernate Core。 当 构建 本 书 的 示例 
时 ，Maven 会 自动 为 你 下 载 Hibernate 和 它 的 所 有 相关 的 依赖 文件 。 即 便 
新 版 的 随 书 代码 示例 可 以 通过 Maven Ant Tasks 来 获取 Hibernate， 你 也 
以 杀 自 下 载 最 新 的 Hibernate 发 布 版 本 ， 浏 览 它 的 源 代码 ， 或 只 是 查看 在 
线 文 档 、 论 坛 或 其 他 支持 资源 。 如 果 你 已 经 准备 好 了 Hibernate， 则 可 以 
跳 过 这 一 节 ， 直 接 学 习 1.7 节 的 内 容 。 














应 该 怎么 做 


先 访 问 Hibernate 的 主页 http://hibernate.org/， 要 获得 其 完整 的 发 布 版 
本 ， 需 要 找到 "Download" 链 接 ， 如 图 1-3 的 左边 所 示 。 
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图 1-3 Hibernate 主页 上 的 Download 链 接 


页 面 上 的 "Binary Releases" 部 分 将 列 出 Hibernate Core 的 推荐 下 载 的 
版 本 《如 果 你 有 足够 的 勇气 ， 可 以 尝试 下 载 “ 开 发 ”〈Development) K 
布 版 本 ， 但 是 最 安全 的 还 是 文 持 下 载 最 新 的 “产品 ”〈《Production ) 发 布 
版 本 ) 。 选 择 好 以 后 ， 点 击 表格 相应 行 上 的 "Download" 链 接 〈 如 图 1-4 
HIZIR) 。 


Binary Releases 


Package Version Release date Category 
Hibernate Core 3.2.5.ga 31.07.2007 Production wnh 


Hibernate Annotations 3.3.0 GA 20.03.2007 Production Download 
Hibernate EntityManager 3.3.1 GA 29.03.2007 Production Download 


Hibernate Validator 3.0.0 GA 20.03.2007 Production Download 
Hibernate Search 3.0.0 Beta4 1.08.2007 Development Download 
Hibernate Shards 3.0.0 Beta2 02.08.2007 Development Download 
Hibernate Tools 3.2.0 Beta9 13.01.2007 Development Download 
NHibernate 1.2.0.GA 03.05.2007 Production Download 
NHibernate Extensions 1.0.4 24.01.2007 Production Download 
JBoss Seam 1.2.0 Patchi 28.02.2007 Production Download 


Browse all Hibernate downloads, Browse all NHibernate downloads 


图 1-4 Hibernate 二 进 制 发 布 版 本 


之 后 会 打开 一 个 SourceForge 的 下 载 页 面 ， 包 含 了 你 刚才 选择 下 载 的 
版 本 ， 以 及 可 供 选 择 的 文档 格式 。 选 择 对 你 最 方便 的 压缩 文件 格式 进行 
下 载 。 下 载 的 文件 名 看 起 来 就 像 hibernate-3.x.y.tar.gz 或 hibernate-3.x.y.zip 
这 样 (在 编写 本 书 时 ， 文 件 名 开始 以 hibernate-3.2.5.ga 命 名 ， 因 为 
Hibernate 3.2.5 的 第 一 个 稳定 版 本 就 是 当前 的 产品 发 布 版 本 ) 。 





选择 一 个 适合 的 地 方 将 文件 解压 。 


在 Hibernate 的 下 载 页 面 ， 也 可 以 看 到 "Hibernate Tools" 部 分 
(Download 链 接 将 打开 一 个 名 为 "JBoss Tools" 的 页 面 ， 不 过 仍然 可 以 在 


上 面 找到 Hibernate Tools) 。 它 们 提供 了 几 个 有 用 的 功能 ， 这 些 功能 
然 不 是 使 用 Hibernate 的 应 用 程序 所 必须 的 ， 但 是 对 开发 人 员 创 建 某 些 应 
用 程序 来 说 非常 有 帮助 。 我 们 稍 后 首次 对 Hibernate 进 行 试验 时 ， 将 使 用 
其 中 的 一 个 工具 来 生成 Java 代 码 。 这 个 工具 的 文件 名 看 起 来 应 该 类 似 于 
hibernatetools-3.x.y.zip 的 样子 (不 一 定 和 Hibernate 本 里 的 版 本 写 一 样 ， 
通常 可 以 使 用 的 只 有 beta 版 本 ; 在 Hibernate 的 下 载 页 面 中 ， 位 于 "Binary 
Releases" 下 面 的 "Compatibility Matrix" (兼容 性 矩阵 ) 表格 显示 了 
Hibernate 各 组 件 之 间 的 相互 兼容 关系 ) 。 











同样 ， 下 载 这 个 文件 ， 将 其 解压 到 存放 Hibernate 的 相关 目录 中 。 








如 果 你 下 载 链接 时 遇 到 麻烦 ， 可 能 是 因为 网 站 正在 维护 ， 处 于 不 稳 
定 的 状态 ， 所 以 就 看 不 到 你 要 的 文件 。 如 果真 遇 到 这 样 的 情况 ， 你 可 以 
点 击 "Binary Releases" 方 框 下 面 的 "Browse all Hibernate downloads" 链 接 ， 
滚动 页 面 ， 查 找 需要 下 载 的 内 容 。Hibernate 项 目 非常 活跃 ， 所 以 发 生 这 
种 情况 比 你 想象 的 要 更 频繁 。 





建立 项 目 层 次 结构 





虽然 起 步 只 是 一 小 步 ， 但 是 ， 当 我 们 开始 设计 数据 结构 ， 并 创建 用 
于 表示 它们 的 Java 类 和 数据 库 表 (database table) ， 再 配合 所 有 配置 文 
件 和 控制 文件 ， 将 全 部 内 容 整 合 起 来 以 发 挥 作 用 时 ， 我 们 最 后 还 是 会 得 
到 一 大 堆 文 件 。 所 以 ， 起 步 时 我 们 得 先 有 个 良好 的 组 织 体系 。 从 前 面 下 
载 的 工具 和 相关 的 支持 库 之 间 就 可 以 看 出 ， 有 许多 文件 得 好 好 加 以 组 
织 。 幸 运 的 是 ，Maven Ant Tasks 可 以 帮 我 们 下 载 和 管理 所 有 的 外 部 依赖 
Xs 

















为 何在 意 





如 末 你 通过 扩展 本 书 的 示例 而 做 出 了 一 些 很 酷 的 东西 ， 想 将 它们 转 
换 成 实用 的 应 用 程序 ， 那 么 你 的 代码 从 一 开始 就 得 有 民 好 的 组 织 。 更 重 
要 的 是 ， 如 果 你 按照 这 里 所 次 的 方式 组 织 ， 我 们 在 示例 中 给 你 的 命令 也 
旨 令 才 会 有 意义 ， 才 能 起 实际 作用 。 书 中 有 很 多 示例 也 彼此 相关 ， 因 此 
一 开始 走 对 路 是 很 重要 的 。 








如 琳 你 想 跳 过 这 一 段 去 看 后 面 的 示例 ， 或 者 不 想 输入 一 些 很 长 的 示 
例 程序 代码 和 配置 文件 ， 则 可 以 从 本 书 网 站 下 载 各 章 示 例 的 “最 终 ” 版 
本 。 这 些 下 载 到 的 文件 的 组 织 方式 的 确 如 这 里 所 述 。 我 们 强烈 建议 你 下 


载 示例 代码 ， 并 将 它们 作为 你 阅读 本 书 时 的 参考 。 


应 该 怎么 做 








以 下 介绍 如 何 建立 一 个 空 的 项 目 层 次 结构 ， 如 果 你 还 没有 下 载 “ 最 


终 的 ”示例 : 


1. 在 便 盘 目录 中 选择 一 个 位 置 ， 作 为 演练 这 些 示 例 的 目录 ， 然 后 创 
建 一 个 新 的 目录 ， 从 现在 开始 ， 我 们 就 称 这 个 目录 为 你 的 项 目 目录 。 


2. 进 入 该 目录 ， 创 建 名 为 src 及 data 的 子 目录 。Java 源 代码 和 相关 资 
源 的 层次 结构 会 放 在 src 目 录 中 。 我 们 的 构建 过 程 在 编译 代码 时 ， 会 将 结 
果 放 在 编译 时 创建 的 classes 目 录 下 ， 然 后 把 运行 时 需要 的 任何 资源 都 复 
制 到 这 个 目录 中 。data 目 录用 于 存放 HSQLDB 数 据 库 相关 的 文件 。 





3. 我 们 打算 创建 的 示例 类 都 将 放 在 com.oreilly.hh (harnessing 
Hibernate) 包 中 ， 而 将 Hibernate 生 成 的 数据 bean 都 放 在 
com.oreilly.hh.data 包 中 ， 以 便 将 它们 与 我 们 手工 创建 的 类 分 离开 来 ， 所 
以 我 们 在 src 目 录 下 创建 这 些 目录 。 在 Linux 和 MacOS X 上 ， 可 以 使 用 以 
下 命令 来 创建 目录 : 





mkdir-p src/com/oreilly/hh/data 





在 项 目 目 录 中 执行 这 个 命令 ,一步 束 可 以 完成 目录 的 创建 。 





这 时 ， 你 的 项 目 目录 结构 应 该 如 图 1-5 所 示 。 


注意 ， 与 本 书 第 1 版 相 比 ， 这 一 版 的 目录 结构 要 简单 得 多 ， 似 乎 不 
值得 一 提 ! 
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图 1-5 最 初 的 项 目 目录 结构 


快速 测试 


在 我 们 真正 使 用 Hibernate 来 做 些 有 用 的 工作 以 前 ， 还 应 该 检查 一 下 
其 他 支持 库 是 否 存 在 和 可 以 使 用 。 我 们 先 从 整个 项 目 都 会 用 到 的 Ant 配 
置 文件 开始 ， 告 诉 Ant 我 们 把 要 用 的 文件 放 在 哪里 ， 同 时 让 Ant 局 动 








HSQLDB 数 据 库 图 形 界 面 。 这 可 以 证 明 Maven Ant Tasks 能 够 找到 并 下 载 
示例 依赖 的 库 ， 可 以 访问 数据 库 图 形 界 面 ， 通 过 这 个 界面 我 们 可 以 查看 
Hibernate 为 我 们 创建 的 真实 数据 。 此 时 只 是 作为 一 个 基本 的 完整 性 检 
查 ， 以 确认 没有 少 什 么 东西 ， 保 证 我 们 为 继续 学 习 做 好 准备 。 




















打开 你 最 喜欢 的 文本 编辑 器 ， 在 项 目 目录 最 顶层 创建 一 个 名 为 
build.xml 的 文件 。 将 例 1-1 的 内 容 输入 到 这 个 文件 中 。 


例 1-1: Ant 构 建 build) 文件 





<?xml version="1.0"?>@ 

<project name="Harnessing Hibernate 3 (Developer's Notebook 
Second Edition) " 

default="db"basedir="." 

xmlns: artifact="antlib: org.apache.maven.artifact.ant">@ 

<! --Set up properties containing important project directories-- 
>09 

<property name="source.root"value="src"/> 

<property name="class.root"value="classes"/> 

<property name="data.dir"value="data"/> 

<artifact: dependencies pathId="dependency.classpath">@ 

<dependency groupid="hsqldb"artifactId="hsgqldb"version="1.8.0.7"/ 

































































<dependency groupId="o0rg.hibernate"artifactId="hibernate" 
version="3.2.5.ga"> 
<exclusion groupId="javax.transaction"artifactId="jta"/> 
</dependency> 

<dependency groupId="org.hibernate"artifactId="hibernate-tools" 
version="3.2.0.beta9a"/> 

<dependency groupId="o0rg.apache.geronimo.specs" 
artifactId="geronimo-jta_1.1 spec"version="1.1"/> 

<dependency groupid="log4j"artifactId="log4j"version="1.2.14"/> 
</artifact: dependencies> 

<! --Set up the class path for compilation and execution--> 
<path id="project.class.path">@ 

<! --Include our own classes, of course--> 

<pathelement location="${class.root}"/>@ 

<! --Add the dependencies classpath--> 































































































<path refid="dependency.classpath"/>@ 











</path> 
<target name="db"description="Runs HSQLDB database management UI 
against the database file--use when application is not running"> 





<java classname="org.hsqldb.util.DatabaseManager" 
fork="yes"> 

<classpath refid="project.class.path"/> 

<arg value="-driver"/> 

<arg value="org.hsqldb.jdbcDriver"/> 

<arg value="-url"/> 

<arg value="jdbc: hsqldb: S{data.dir}/music"/> 
<arg value="-user"/> 

<arg value="sa"/> 

</java> 

</target> 

</project> 




















输入 时 要 小 心 那 些 标点 符号 ， 对 于 自 结束 的 《self-closing) XML 标 
签 更 要 小 心 〈 是 % >”， 而 不 是 ">”) 。 如 果 输 入 错误 ， 代 价 就 是 运行 
Ant 时 得 到 解析 错误 的 信息 。 如 果 你 不 想 手工 输入 这 些 文件 的 内 容 ， 可 
以 从 本 书 网 站 下 载 这 些 文件 。 如 果 你 正在 阅读 的 是 PDF 电子 文档 ， 也 可 
以 剪 切 和 粘贴 代码 ， 但 需要 去 掉 一 些 无 关 的 排版 字符 。 





如 宁 你 以 前 没有 看 过 Ant 构 建文 件 ， 以 下 简单 介绍 可 以 帮助 你 熟悉 
它 。《〈 如 宋 你 想 碍 看 更 多 的 细节 ， 可 以 访问 文档 


http://ant.apache.org/manual/index.html. ) 


全 第 1 行 只 是 声明 这 个 文件 的 类 型 是 XML 。 如 果 你 以 前 在 其 他 情况 
下 用 过 XML， 残 应 该 很 习惯 这 种 文件 格式 ; 如 果 没 有 ， 那 就 再 看 一 次 
CAnt 目 前 不 需要 这 一 行 ， 但 大 多 数 XML 解 析 器 都 需要 ， 因 此 养 成 这 种 
习惯 是 一 件 好 事 ) 。 





四 Ant 的 构建 文件 总 包含 一 个 project 定 义 。default 属 性 用 于 告诉 
Ant， 如 果 在 命令 行 没 有 指定 要 构建 任何 目标 〈target) ，Ant 要 默认 构 
建 哪个 目标 (后 面 会 定义 ) 。basedir 属 性 用 于 指定 所 有 路 径 计 算 都 对 应 
于 哪个 目录 。 我 们 可 以 不 指定 这 个 属性 ， 因 为 在 默认 情况 下 总 是 将 
build.xml 所 在 的 目录 作为 相对 目录 的 基本 目录 ， 但 是 明确 指定 类 似 的 基 
本 设置 是 一 种 好 习惯 。 在 这 个 project 元 素 中 需要 注意 的 一 个 重要 事情 
是 ，xmlns: artifact 是 专门 为 Maven Ant Tasks 提 供 的 命名 空间 定义 。 该 
命名 空间 定义 使 用 了 artifact 前 级 ， 这 样 就 可 以 在 构建 文件 中 使 用 Maven 
Ant Tasks 了 【后面 有 具体 的 使 用 方法 )。 




















@ 接 下 来 的 几 行 定义 了 3 个 属性 ， 我 们 可 以 在 构建 文件 的 其 他 部 分 
中 ， 通 过 名 称 来 引用 相应 的 属性 。 基 本 上 ， 我 们 在 此 是 为 项 目 中 各 个 部 
分 用 到 的 重要 目录 定义 其 符号 名 称 。 这 样 做 并 非 必要 尤其 是 目录 名 称 
非常 简单 时 ) ， 不 过 这 也 是 一 种 好 习惯 。 至 少 ， 如 果 你 得 修改 这 些 目录 
中 的 某 个 目录 时 ， 只 需要 修改 构建 文件 中 的 一 个 地 方 ， 而 不 用 进行 楷 殴 
的 搜索 和 蔡 换 操作 。 








@artifact: dependencies 元 素来 源 于 Maven Ant Tasks， 你 (以 及 
Ant) 可 以 通过 artifact: 前 缀 判断 出 这 一 点 。 在 这 个 元 素 中 ， 我 们 定义 
了 一 套 依赖 ， 项 目 需要 它们 才 可 以 编译 和 执行 。 这 些 依赖 对 应 于 Maven 
2 Repository 〈 位 于 http:/repol.maven.org/maven2) 中 央 仓 库 中 的 JAR 文 
件 (或 其 他 生成 文件 ) 。 每 个 artifact (工件 ) 由 一 个 groupId、artifactId 





以 及 version 写 进行 惟一 标识 。 在 这 个 项 目 中 ， 我 们 需要 依靠 Hibernate、 
HSQLDB、Log4J 以 及 JTA API. “4Maven Ant Tasks 遇 到 这 些 依赖 声明 

时 ， 就 会 从 Maven 2 中 央 仓 库 中 按照 需要 将 每 个 artifact 下 载 到 你 的 本 地 
Maven 2 仓库 中 (在 ~~/.m2/repository 目 录 下 ) 。 如 果 你 对 这 一 区 段 的 配 
置 内 容 还 没有 什么 感觉 ， 大 可 不 必 担 心 ， 在 稍 后 几 页 的 内 容 中 ， 我 们 将 
深入 探索 相关 的 细节 。 如 果 需 要 ， 你 可 以 对 这 一 区 段 的 配置 作出 修改 

《只 要 修改 version 值 ) ， 以 便 使 用 这 些 依赖 的 程序 包 的 更 新 版 本 《因为 
在 本 书 交 付 印 刷 之 后 ， 可 能 会 有 新 版 本 推出 ) 。 不 过 你 可 以 放心 ， 本 书 
印刷 出 版 后 ， 书 中 的 例子 将 一 定 能 够 正常 运行 ， 因 为 不 论 你 什么 时 候 研 
究 这 些 例子 ，Maven 仓 库 可 以 确保 我 们 测试 过 的 版 本 总 是 可 用 的 。 我 们 
之 所 以 在 本 书 中 采用 Maven Ant Tasks， 这 也 是 很 大 的 一 部 分 原因 。 





加 class-path 区 段 的 用 途 很 明确 。 这 个 功能 正 是 我 每 次 做 Java 项 目 
时 ， 几 乎 总 要 为 其 配置 一 个 简单 的 Ant 构 建文 件 的 原因 。 无 论 做 什么 规 
模 的 项 目 ， 总 是 需要 将 很 多 第 三 方程 序 库 放 到 类 路 径 中 ， 而 且 还 得 确保 
编译 时 和 运行 时 的 配置 都 完全 一 样 。Ant 使 得 这 一 工作 变 得 很 简单 。 我 
们 定义 了 一 个 path， 有 点 像 一 个 属性 ， 但 是 它 知 道 应 该 如 何 解析 、 收 集 
文件 和 目录 信息 。 我 们 的 类 路 径 包含 classes 目 录 ， 经 过 编译 的 Java 文 件 
就 放 在 这 个 目录 中 这 个 目录 现在 还 不 存在 ; 下 一 章 会 在 构建 处 理 中 多 
增加 一 个 步骤 以 创建 它 ) ， 此 外 ， 也 包含 与 artifact: dependencies% 
中 列 出 的 依赖 相对 应 的 所 有 JAR 文 件 。 这 正 是 编译 和 运行 项 目 所 需要 的 
= 























对 于 Java 路 径 和 类 层次 结构 的 理解 和 处 理 来 说 ，Ant 是 一 个 很 棒 的 
工具 ， 值 得 我 们 深入 学 习 。 








@ 这 一 行 的 标点 符号 有 点 令 人 迷惑 ， 但 实际 上 可 以 划分 成 具有 意义 
的 几 个 部 分 。Ant 可 以 使 用 置换 (substitution〉 机 制 ， 将 变量 值 插 入 到 规 
则 中 。 当 你 看 到 像 "${class.root}" 这 样 的 语句 时 ， 这 表示 “寻找 名 为 
classroot 的 属性 值 ， 用 这 个 值 来 置换 这 里 的 字符 串 ”。 所 以 ， 根 据 前 面 
对 class.root 的 定义 ， 置 换 的 结果 就 好 像 是 在 这 里 输入 了 : ~<pathelement 
location="classes 之 。 那 么 ， 为 什么 要 这 么 做 呢 ? 这 是 为 了 可 以 在 整个 
构建 文件 中 共享 某 个 属性 值 ， 这 样 ， 如 果 需 要 修改 相关 的 配置 ， 则 只 需 
要 关注 一 个 地 方 就 可 以 了 。 在 大 型 的 复杂 项 目 中 ， 这 种 组 织 和 管理 是 很 
重要 的 。 











@ 我 们 在 前 面 看 到 的 artifact: dependencies 元 素 使 用 它 的 pathId 属 
性 ， 将 所 有 声明 的 依赖 组 装 到 一 个 名 为 dependency.classpath 的 路 径 中 。 
这 里 ， 我 们 将 dependency.classpath 的 内 容 附 加 到 project.class.path 中 ， 以 
便 在 编译 和 运行 时 可 以 找到 我 们 用 Maven 取 回 的 依赖 包 。 





全 最 后 ， 这 些 前 期 工作 做 好 以 后 ， 我 们 就 能 够 定义 第 一 个 构建 目标 
了 。 一 个 目标 其 实 就 是 一 系列 任务 ， 为 了 完成 项 目的 目标 ， 必 须 按 顺 序 
执行 任务 。 典 型 的 构建 目标 束 是 做 些 类 似 于 编译 代码 、 运 行 测试 、 为 及 
布 而 打包 文件 等 各 种 事情 。 可 以 从 Ant 内 建 的 一 组 丰富 的 功能 中 选择 任 
务 ， 而 像 Hibernate 这 样 的 第 三 方 工具 则 可 以 扩展 Ant， 以 便 提供 它们 目 








己 的 任务 ， 这 在 下 一 章 就 会 看 到 。 我 们 的 第 一 个 构建 目标 是 db， 它 会 运 
行 HSQLDB 的 图 形 界面 ， 让 我 们 查看 示例 数据 库 。 我 们 可 以 用 Ant 内 建 
的 java 任 务 来 完成 这 项 工作 ， 它 会 为 我 们 运行 Java 虚 拟 机 ， 并 配置 好 我 
们 需要 的 启动 类 、 参 数 (argument) 以 及 属性 。 


就 此 例 而 言 ， 我 们 想 要 调用 的 类 是 
org.hsqldb.util.DatabaseManager， 在 HSQLDB JAR 中 可 以 找到 这 个 类 
(Maven Ant Tasks 将 为 我 们 管理 这 个 依赖 ) 。 将 fork 属 性 设置 为 "yes"， 
这 是 告诉 Ant 使 用 另 一 个 单独 的 虚拟 机 ， 而 不 是 默认 的 虚拟 机 ， 因 为 默 
认 虚 拟 机 得 花费 比较 长 的 时 间 ， 而 且 通 常 没有 这 个 必要 。 在 这 个 例子 
中 ， 这 一 点 很 重要 ， 因 为 我 们 想 让 数据 库 管理 器 GUI 一 直 保 持 运行 ， 直 
到 我 们 关 掉 它 ， 但 是 ， 如 果 在 Ant 自 己 的 VM 中 运行 ， 就 达 不 到 这 样 的 效 
Ro 











如 果 你 的 数据 库 GUI 弹 出 后 ， 束 马上 消失 ， 请 再 次 检查 你 的 java 任 
务 的 fork 属 性 。 


你 可 以 看 到 我 们 先是 如 何 告诉 java 任 务 ， 有 关 之 前 已 经 配置 好 的 类 
路 径 信息 的 《这 是 我 们 所 有 的 构建 目标 都 得 使 用 的 配置 属性 ) 。 然 后 ， 
我 们 为 数据 库 管 理 器 提供 了 很 多 参数 ， 告 诉 它 使 用 标准 的 HSQLDB 
JDBC 驱 动 程 序 ， 到 哪儿 去 找 数据 库 ， 以 及 使 用 的 用 户 名 是 什么 。 我 们 
在 data 目 录 中 指定 了 一 个 名 为 music 的 数据 库 。 这 个 目录 当前 还 是 空 的 ， 
所 以 HSQLDB 会 在 我 们 第 一 次 使 用 时 创建 这 个 数据 库 。 新 数据 库 默 认 











的 “系统 管理 员 ” 用 户 名 是 saa， 最 初 的 配置 是 一 开始 不 需要 密码 。 显 然 ， 
如 果 你 计划 让 数据 库 在 网 络 上 也 可 以 使 用 (HSQLDB 能 够 做 得 到 〉 ， 就 
再 要 设置 密码 。 我 们 不 需要 做 这 些 人 花哨 的 事 ， 所 以 现在 先 不 用 理会 其 他 
配置 。 


OK， 让 我 们 试 一 下 吧 ! 保存 好 这 个 文件 ， 在 你 的 顶级 项 目 目录 
(build.xml 所 在 的 目录 〉 的 命令 提示 行 中 输入 以 下 命令 : 





ant db 





(或 者 ， 因 为 我 们 将 db 设置 为 默认 的 构建 目标 ， 你 也 可 以 只 输入 
ant) 在 Ant 开 始 运 行 以 后 ， 如 果 一 切 顺利 ， 你 会 看 到 像 下 面 这 样 的 输出 
结果 : 





Buildfile: build.xml] 

Downloading: hsqldb/hsqldb/1.8.0.7/hsqldb-1.8.0.7.pom 

Transferring OK 

Downloading: org/hibernate/hibernate/3.2.5.ga/hibernate- 
3.2.5.ga.pom 

Transferring 3K 

Downloading: net/sf/ehcache/ehcache/1.2.3/ehcache-1.2.3.pom 

Transferring 19K 

Downloading: commons-logging/commons-logging/1.0.4/commons- 
logging-1.0.4.pom 

Transferring 5K 

Downloading: commons-collections/commons-collections/2.1/commons- 
collections- 

2.1.pom 

Transferring 3K 

Downloading: asm/asm-attrs/1.5.3/asm-attrs-1.5.3.pom 

Transferring 0K 

Downloading: dom4j/dom4j/1.6.1/dom4j-1.6.1.pom 

Transferring 6K 
Downloading: antlr/antlr/2.7.6/antlr-2.7.6.pom 









































Transferring OK 

Downloading: cglip/cglip/2.1 3/cglib-2.1 3.pom 

Transferring OK 

Downloading: asm/asm/1.5.3/asm-1.5.3.pom 

Transferring OK 

Downloading: commons-collections/commons- 
collections/2.1.1/commons-collections- 

2.1.1.pom 

Transferring OK 

Downloading: org/hibernate/hibernate-tools/3.2.0.beta9a/hibernate- 
tools- 

3.2.0.beta9a.pom 

Transferring 1K 

Downloading: org/hibernate/hibernate/3.2.0.cr5/hibernate- 
3324-0:.62 5%: poOm 

Transferring 3K 

Downloading: freemarker/freemarker/2.3.4/freemarker-2.3.4.pom 

Transferring OK 

Downloading: org/hibernate/jtidy/r8-20060801/jtidy-r8-20060801.pom 

Transferring OK 

Downloading: org/apache/geronimo/specs/geronimo- 
jta 1.1 spec/1.1/geronimo- 

jta 1.1 spec-1.1.pom 

Transferring 1K 

Downloading: org/apache/geronimo/specs/specs/1.2/specs-1.2.pom 

Transferring 2K 

Downloading: org/apache/geronimo/genesis/config/project- 
config/1.1/project- 

config-1.1.pom 

Transferring 14K 






























































































































































Downloading: org/apache/geronimo/genesis/config/config/1.1/config- 
. pom 

Downloading: org/apache/geronimo/genesis/config/config/1.1/config- 
. pom 

Downloading: org/apache/geronimo/genesis/config/config/1.1/config- 
. pom 

Transferring 0K 

Downloading: org/apache/geronimo/genesis/genesis/1.1/genesis- 

. pom 

Downloading: org/apache/geronimo/genesis/genesis/1.1/genesis- 

. pom 

Downloading: org/apache/geronimo/genesis/genesis/1.1/genesis- 

. pom 














Transferring 6K 
Downloading: org/apache/apache/3/apache-3.pom 
Downloading: org/apache/apache/3/apache-3.pom 
Downloading: org/apache/apache/3/apache-3.pom 
Transferring 3K 








Downloading: log4j/10g43/1.2.14/log4j-1.2.14.pom 


Trans 
Down] 








ferring 2K 








tools- 


3.2.0.beta9a.jar 


Transi 


Down] 


ferring 352K 





Trans 





Downloading: commons-collections/commons- 
collections/2.1.1/commons-collections- 


2adkel 
Trans 


.jar 





ferring 


171K 








oading: org/hibernate/hibernate-tools/3.2.0.beta9a/hibernate- 


oading: org/hibernate/jtidy/r8-20060801/jtidy-r8-20060801.jar 
ferring 243K 


Downloading: commons-logging/commons-logging/1.0.4/commons- 
logging-1.0.4.jar 


Trans 


ferring 


37K 


Downloading: antlr/antlr/2.7.6/antlr-2.7.6.jar 


Trans 





ferring 


433K 


Downloading: org/apache/geronimo/specs/geronimo- 


jta_1.1_ 
jta_ 
Trans 


spec/1.1/geronimo- 
Lek spec-l.4d.jar 
ferring 


15K 





Downloading: n 
ferring 


Trans 


Downloading: 


Trans 


ferring 


Downloading: 


Trans 


ferring 


Downloading: 


Trans 


ferring 


Downloading: 


Trans 


ferring 








203K 


asm/asm/1.5.3/asm-1.5.3.jar 


25K 
freemarker/f 
770K 








r 











dom4j/dom4j/1.6.1/dom4j-1. 


306K 


marker/2.3. 


4/freemarker-2 





Gig ks 


jar 


asm/asm-attrs/1.5.3/asm-attrs-1.5.3.jar 


16K 





Downloading: 


Trans 





ferring 








cglib/cglib/2.1 
275K 
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et/sf/ehcache/ehcache/1.2.3/ehcache-1.2.3.jar 


.3.4.JjJar 


Downloading: hsqlidb/hsgqldb/1.8.0.7/hsqldb-1.8.0.7.jar 

Transferring 628K 

Downloading: log4j/10g43/1.2.14/1log4j-1.2.14.jar 

Transferring 358K 

Downloading: org/hibernate/hibernate/3.2.5.ga/hibernate- 
3.2.5.ga.jar 

Transferring 2202K 

db: 





一 大 堆 下 载 文件 信息 表明 Maven Ant Tasks 完 成 了 它 的 任务 ， 为 我 们 
下 载 了 指定 的 文件 〈 包 括 HSQLDB 和 Hibernate) 以 及 所 有 依赖 的 库 文 





件 。 这 一 过 程 可 能 需要 花费 一 段 时 间 才 能 完成 《取决 于 网 络 连接 的 速度 
和 服务 器 的 情况 ) ， 但 是 它 只 进行 一 次 。 下 一 次 再 运行 Ant 时 ，Maven 
Ant Tasks 就 会 注意 到 你 的 本 地 库 中 已 经 包含 了 所 有 这 些 文件 ， 就 会 默认 
继续 执行 其 他 需要 完成 的 任务 了 。 


在 所 有 下 载 完 成 以 后 ，Ant 会 打印 输出 "db:"， 表 明 它 正 开 始 执行 你 
请 求 的 目标 。 一 会 儿 ， 你 应 该 会 看 到 HSQLDB 的 图 形 界面 ， 如 图 1-6 所 
示 。 我 们 的 数据 库 现 在 还 没有 什么 东西 ， 所 以 ， 除 了 命令 能 运行 以 外 ， 
没有 其 他 内 容 。 窗 口 左 上 部 的 树 形 视图 是 数据 库 中 可 以 浏览 的 各 种 数据 
表 和 字段 。 就 目前 而 言 ， 只 要 确认 最 上 层 是 否 
为 "jdbc:hsqldb:data/music" 就 可 以 了 。 
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图 1-6 HSQLDB 数 据 库 管理 器 界面 





如 有 果 你 喜欢 ， 可 以 浏览 一 下 沫 单 ， 但 不 要 对 数据 库 进 行 任何 修改 。 
在 完成 以 后 》 选择 "File" + "Exit", fa 口 就 会 关闭 同时 Ant 将 报告 以 下 


BUILD SUCCESSFUL 
Total time: 56 seconds 














"Total time" 是 你 运行 这 个 数据 库 管 理 器 程序 所 用 的 时 间 ， 所 以 其 值 
古 变 化 的 《刚才 我 们 在 Ant 的 构建 文件 中 为 java 任 务 设置 了 fork 属 性 ， 所 
以 直到 关闭 数据 库 以 前 ，Ant 会 一 直 等 待 ) 。 此 时 ， 如 果 你 查看 data 目 
录 ， 你 会 及 现 HSQLDB 已 经 创建 了 一 些 文件 来 保存 数据 库 信息 : 


sls data 
music.log music.properties music.script 





你 甚至 可 以 查看 这 些 文件 的 内 容 。 和 大 多 数 数据 库 系 统 不 同 ， 
HSQLDB 是 以 人 类 可 读 的 格式 来 存储 数据 的 。.properties 文 件 中 包含 一 
些 基本 设置 ， 而 .script 文 件 中 的 数据 则 以 SQL 语句 的 形式 保存 。.log 文 件 
用 于 当 应 用 程序 骨 溃 或 没有 正常 关闭 数据 库 而 强行 退出 时 ， 可 以 重新 构 
建 一 致 的 数据 库 状 态 。 现 在 ， 你 在 这 些 文件 中 看 到 的 都 是 基本 定义 ， 都 
是 默认 值 ， 以 后 我 们 开始 创建 数据 表 并 添加 数据 时 ， 就 可 以 看 到 这 些 文 
件 会 有 所 变化 。 这 也 可 以 作为 一 种 有 用 的 调试 手段 来 进行 基本 的 完整 性 
检查 ， 甚 至 比 启动 图 形 界面 执行 查询 还 要 快 。 























注意 : 能 够 直接 读 取 HSQLDB 数 据 库 文件 的 内 容 ， 是 一 件 诡异 但 有 
趣 的 事 。 


BET IPA St 


目前 我 们 已 经 成 功 运行 了 第 一 个 示例 ， 建 立 了 我 们 的 项 目 构建 文 
件 ， 现 在 解释 Ant 如 何 取 回 这 个 项 目 必需 的 依赖 文件 。 我 们 再 查看 一 下 
示例 的 build.xml 文 件 中 的 artifact: dependencies 元 素 〈 如 例 1-2 所 示 ) 。 





例 1-2: artifact: dependencies 元 素 











<artifact: dependencies pathId="dependency.classpath"> 
<dependency groupid="hsqldb"artifactId="hsqldb"version="1.8.0.7"/ 
































<dependency groupId="0rg.hibernate"artifactId="hibernate" 
version="3.2.5.ga"> 
<exclusion groupId="javax.transaction"artifactId="jta"/> 
</dependency> 
<dependency groupId="org.hibernate"artifactId="hibernate-tools" 
version="3.2.0.beta9a"/> 

<dependency groupId="o0rg.apache.geronimo.specs" 
artifactId="geronimo-jta_1.1 spec"version="1.1"/> 

<dependency groupId="log4j"artifactId="log4j"version="1.2.14"/> 
</artifact: dependencies> 







































































如 果 你 以 前 从 没有 用 过 Maven， 这 个 例子 看 起 来 非常 令 人 费解 。 我 
们 先 定 义 一 些 术 语 。 首 先是 artifact。 一 个 artifact 就 是 项 目 生 成 的 一 个 文 
件 ， 它 可 以 是 任意 类 型 的 文件 一 Web 应 用 程序 的 WAR 文 件 、 企 业 应 用 
程序 的 EAR 文 件 或 是 简单 的 JAR 文 件 。 对 于 我 们 的 用 途 来 说 ， 我 们 使 用 
的 是 JAR artifact， 如 果 你 不 在 dependency 元 素 中 指定 它 ， 其 默认 的 类 型 


就 是 jar， 非 常 方便 。 





artifact 有 4 个 属性 : groupId、artifactId4、version 以 及 type。 例 如 ， 我 


们 需要 org.hibernate 组 内 的 hibernate artifact， 其 版 本 是 3.2.5.ga， 文 件 类 
型 是 jar。Maven 将 使 用 这 些 标识 符 在 位 于 http:/repol.maven.org/maven2/ 
的 中 央 Maven 2 库 中 来 碍 找 定位 适当 的 依赖 文件 。 使 用 这 些 值 ，Maven 
将 通过 以 下 模式 来 尝试 定位 Hibernate 的 JAR: <repositoryUrl>/< 











groupId >/<artifactlId >/< version >/<artifactlId >-<version>.<type 
>， 其 中 ，groupId 中 的 点 号 “.” 将 转换 成 UREL 的 路 径 分 隔 符 。 使 用 这 样 
的 模式 ， 就 可 以 定位 Hibernate 和 HSQLDB 依 赖 的 JAR 文 件 了 ， 如 例 1-3 所 


ZN o 


例 1-3: 项 目 依赖 文件 的 URL 








http://repol.maven.org/org/hibernate/hibernate/3.2.5.ga/hibernate- 
3.2.5.ga.jar 
http://repol.maven.org/hsqldb/hsgqldb/1.8.0.7/hsqldb-1.8.0.7.Jjar 























在 build.xml 文 件 中 ， 我 们 没有 在 Hibernate 依 赖 声 明 中 包含 JTA 依 
赖 。 这 是 因为 Hibernate 库 使 用 的 是 一 个 非 自 由 (nonfree〉 的 JAR 文 件 ， 
所 以 Maven 2 公共 库 中 没有 这 个 文件 。 这 个 项 目 没有 使 用 Sun 提 供 的 标准 
JTA API JAR， 而 是 使 用 了 Apache Geronimo 项 目 创建 的 JTA API. 
geronimo-jta_1.1_spec 是 Java Transaction API. 的 一 个 自由 的 开源 实现 版 
本 。 这 个 替换 是 通过 在 Hibernate 3.2.5.ga 的 依赖 声明 中 使 用 exclusion 元 
素来 实现 的 ， 并 随后 明确 声明 了 需要 使 用 Geronimo JTA spec 1.1。 


好 了 ， 我 们 已 经 介绍 了 Maven Ant Tasks 如 何 从 Maven 库 中 取 回 依赖 





文件 ， 但 是 ， 如 果 已 经 下 载 好 了 这 些 依赖 文件 ， 又 会 怎么 样 呢 ? Maven 
Ant Tasks 将 所 有 的 依赖 文件 都 下 载 到 一 个 本 地 的 Maven 库 中 ， 由 Maven 
负责 维护 这 个 本 地 库 ， 使 其 结构 与 远程 Maven 库 的 结构 保持 一 致 。 当 需 
要 检查 某 个 artifact 时 ，Maven 先 检查 本 地 库 ， 如 果 本 地 库 没有 这 个 
artifact 时 ， 再 从 远程 库 中 请 求 该 artifact。 这 意味 着 ， 如 果 同 时 有 20 个 项 
目 都 引用 了 同一 版 本 的 Hibernate， 从 Maven 远 程 库 中 只 下 载 一 次 
Hibernate 的 依赖 artifact， 所 有 20 个 项 目 都 会 引用 保存 在 本 地 Maven 库 中 
的 同一 个 副本 。 那 么 ， 这 个 不 可 思议 的 本 地 Maven 库 是 放 在 哪里 呢 ? 最 
简单 的 回答 就 是 ， 在 build.xml 文 件 中 添加 一 个 目标 。 在 原来 的 Ant 
build.xml 的 末尾 添加 以 下 目标 ， 如 例 1-4 所 示 。 








例 1-4: 打印 输出 依赖 类 的 路 径 





<target name="print-classpath"description="Show the dependency 
class path"> 

<property name="class.path"refid="dependency.classpath"/> 

<echo>S${class.path}</echo> 

</target> 














运行 这 个 目标 ， 将 生成 以 下 输出 结果 : 





sant print-classpath 
Buildfile: build.xml 
print-classpath: 
[echo] ~\.m2\repository\commons-logging\commons-logging\1.0.4\ 
commons-logging-1.0.4.jar; \ 
~\.m2\repository\dom4j\dom4j3\1.6.1\dom4j-1.6.1.jar; \ 
~\.m2\repository\cglib\cglib\2.1 3\cglib-2.1 3.jar; Nass 
| | 























运行 该 目标 ， 输 出 结果 会 随 你 正在 使 用 的 操作 系统 的 不 同 而 有 所 变 
化 ， 不 过 ， 你 可 以 看 到 ， 依 赖 类 的 路 径 都 引用 了 本 地 Maven 库 。 在 运行 
Windows XP 的 计算 机 上 ， 这 一 路 径 可 能 位 于 C: \Documents and 
Settings\Username\.m2\repository; 在 运行 Windows Vista 的 计算 机 上 ， 这 
一 路 径 则 可 能 位 于 C: \Users\Username\.m2\repository; 而 在 Unix 和 


Macintosh 上 ， 访 路径 将 会 是 一 /m2/repository 目 录 。 


你 也 可 能 会 注意 到 ， 在 类 路 径 中 列 出 的 依赖 文件 的 数目 要 比 我 们 在 
build.xml 的 artifact: dependency 元 素 中 声明 的 多 。 这 些 额 外 的 依赖 瓯 是 
所 谓 的 可 传递 的 依赖 (transitive dependency) ， 它 们 是 你 明确 声明 的 依 
赖 文件 所 需要 的 依赖 。 例 如 ，Hibernate 需 要 依赖 CGLib、EHCache、 
Commons Collections 以 及 其 他 程序 库 。 对 Maven 的 详细 介绍 超出 了 本 书 
讨论 的 范围 ， 我 在 这 里 只 对 Maven Ant Tasks 如 何 为 你 的 项 目 构造 整套 依 
赖 结构 提供 一 些 提示 。 如 果 在 构建 好 一 个 示例 后 ， 你 查看 一 下 本 地 
Maven 库 ， 你 会 注意 到 在 每 个 JAR artifact 旁 边 会 有 一 个 扩展 名 为 .pom 的 
项 目 对 象 模型 (POM) 文件 。POM 是 Maven 构 建 系统 和 仓库 的 基础 ， 每 
一 个 POM 描 述 了 一 个 artifact 和 它 的 依赖 。Maven Ant Tasks 使 用 这 种 元 数 
据 (metadata) 来 构造 一 个 描述 依赖 传递 关系 的 树 状 结构 。 换 名 话说 ， 
Maven Ant Tasks 并 不 只 是 负责 下 载 Hibernate， 它 们 还 负责 下 载 Hibernate 
依赖 的 所 有 文件 。 





你 实际 需要 知道 的 是 它 的 工作 原理 就 是 这 样 的 。 


接 下 来 做 什么 


感谢 Maven Ant Tasks， 有 了 它 ， 就 不 用 像 本 书 的 最 初版 本 那样 杀 目 
查找 、 下 载 、 解 压 软件 ， 并 组 织 好 它们 。 现 在 你 可 以 从 一 个 更 高 的 起 点 
来 开始 使 用 Hibernate， 在 下 一 半 中 你 可 以 看 到 ， 我 们 的 进展 会 非常 快 
速 。 你 将 看 到 Hibernate 已 经 为 你 写 好 了 Java 代 人 码 ! 数据 库 模式 (database 
schema) 也 好 像 是 从 天 而 降 一样 〈 或 者 ， 至 少 是 来 目 于 产生 Java 程 序 代 
码 的 同一 个 XML 映射 表 ) ! 真正 的 数据 表 和 数据 也 会 出 现在 HSQLDB 
管理 器 界面 中 《或 者 ， 至 少 是 示范 数据 ) ! 





PERS AN BE? 嗯 ， 和 你 以 前 的 开发 方法 相 比 如 何 ? 我们 继续 
研究 下 去 ， 把 Hibernate 的 强大 功能 唤醒 吧 。 


为 何 无 法 工作 





如 果 你 没有 看 到 数据 库 管理 器 窗口 ， 而 是 出 现 了 错误 信息 ， 那 么 应 


` 














该 尝试 弄 清楚 是 否 是 文件 构建 出 了 问题 ， 是 否 是 安装 设置 Ant 或 项 目 层 
次 结构 出 错 ; 是 否 是 因为 访问 Internet 困 难 ， 而 不 能 从 Maven 库 下 载 到 依 


赖 文件 ， 或 是 其 他 什么 原因 。 再 次 确认 所 有 东西 都 安排 习 当 ， 并 且 按 照 
前 面 介绍 的 方式 正确 地 安装 。 如 果 是 目 己 输入 的 文件 有 问题 ， 可 以 考虑 
下 载 示 例 程序 。 


第 2 章 ” 映 射 简 介 


我 们 已 经 开始 使 用 Hibernate 了。 不 过 现在 ， 我 们 要 移 停 下 回 前 迈进 
的 脚步 ， 站 在 一 定 高 度 观察 一 下 Hibernate 的 全 貌 ， 以 免 迷 失 在 Hibernate 
安 六 和 配置 的 繁 文 强 市 之 中 ， 这 是 非常 必要 的 。 像 Java 这 样 的 面向 对 象 
语言 提供 了 强大 而 方便 的 抽象 层 ， 可 以 在 运行 时 以 对 象 〈 类 的 实例 ) 的 
形式 来 处 理 信 息 。 这 些 对 象 之 间 可 以 通过 各 种 方式 链接 起 来 ， 除 了 它们 
本 号 所 拥有 的 原始 数据 外 ， 还 可 以 包含 规则 和 行为 。 但 是 ， 当 程序 运行 
结束 时 ， 所 有 对 象 都 会 消失 得 无 影 无 踪 。 























对 于 那些 在 程序 多 次 运行 之 间 需 要 保存 下 来 的 信息 ， 或 者 是 需要 在 
不 同 程序 或 系统 之 间 共 享 的 信息 ， 实 践 证 明 关 系数 据 库 是 难以 击败 的 最 
佳 解决 方案 。 关 系数 据 库 具有 高 度 的 可 伸缩 性 、 可 靠 性 、 高 效 性 以 及 灵 
活性 。 所 以 ， 我 们 需要 有 一 种 方式 可 以 把 信息 从 SQL 数据 库 中 提取 出 
来 ， 再 将 其 转换 成 Java 对 象 ， 反 之 亦 然 。 











实现 这 一 功能 有 许多 不 同 的 方法 ， 从 完全 手工 的 数据 库 设计 和 编 
码 ， 到 高 度 自 动 化 的 工具 ， 都 有 相应 的 解决 方案 。 这 个 普遍 性 问题 就 是 
人 们 所 谓 的 对 象 /关系 数据 库 映 射 〈ObjecVRelational Mapping) 问题 ， 而 
Hibernate 正 是 Java 中 一 种 轻 量 级 的 O/R 映 射 服务 。 


所 谓 “ 轻 量 级 ”(lightweight) 是 指 ， 和 其 他 一 些 可 用 的 工具 相 比 ， 


Hibernate 的 设计 相当 易于 学 习 和 使 用 ， 同 时 对 系统 资源 的 需求 也 在 合理 
的 范围 内 。 虽 然 如 此 ，Hibernate 还 是 设法 达到 了 用 途 广泛 而 又 有 技术 的 
深度 。Hibernate 的 设计 者 对 实际 项 目 中 需要 完成 的 工作 进行 了 细致 的 研 
完 ， 并 对 这 些 工作 提供 展 好 的 支持 。 











Hibernate 的 使 用 方法 有 很 多 种 ， 这 要 取决 于 你 开始 时 着 手 的 对 象 。 
如 果 需 要 交互 的 数据 库 已 经 存在 ， 则 可 以 用 Hibernate 的 一 些 工 具 对 现 有 
的 数据 库 模 式 (schema) 进行 分 析 ， 以 此 作为 映射 mapping) 的 起 
点 ， 之 后 ， 它 再 帮助 你 编写 一 些 用 于 表示 那些 数据 的 Java 类 。 如 果 你 己 
经 有 了 Java 类 ， 并 希望 把 这 些 类 的 实例 中 的 数据 保存 在 数据 库 中 ， 则 可 
以 从 这 些 Java 类 开始 ， 用 Hibernate 工 具 生 成 相应 的 映射 文件 ， 再 生成 用 
于 创建 数据 库 表 的 模式 脚本 。 





在 本 书 中 ， 我 们 将 要 带领 你 从 一 个 全 新 的 项 目 开始 ， 没 有 现成 的 
Java 类 或 数据 库 表 ， 让 Hibernate 帮 助 你 生成 这 些 类 和 数据 库 表 。 当 像 这 
样 从 头 做 起 时 ， 最 佳 的 切入 点 就 是 二 者 之 间 的 一 个 中 间 点 ， 也 就 是 我 们 
打算 在 程序 对 象 和 存储 这 些 对 象 的 数据 表 之 间 使 用 的 映射 的 抽象 定义 。 
附录 FE 就 如 何 深入 学 习 Hibernate 列 举 了 一 些 建 议 ;， 如果 你 愿意 使 用 
Eclipse， 第 11 章 还 得 介绍 如 何在 Eclipse 中 使 用 Hibernate。 











对 于 那些 已 经 习惯 处 理 Java 对 象 ， 而 对 抽象 模式 比较 陌生 的 开发 人 
员 来 说 ， 他 们 在 熟悉 这 种 方法 之 前 ， 可 能 会 遇 到 些小 麻烦 ， 或 许 只 是 为 
一 个 外 部 的 XML 文件 费 神 而 已 。 第 7 章 会 演示 如 何 使 用 Java 5 的 标注 ， 





EVRA BH AS HR ARS. FS ESE XML RY ee E 
的 ， 所 以 我 们 就 从 它 开始 学 习 Hibernate。 





在 我 们 的 示例 中 ， 我 们 将 处 理 一 个 数据 库 ， 用 它 来 驱动 一 个 应 用 程 
序 界面 ， 用 户 可 以 保存 许多 个 人 首 乐 收藏 数据 ， 还 可 以 方便 地 进行 搜 
索 、 浏 览 和 欣 偶 音乐 《第 1 章 最 后 创建 了 一 些 数据 库 文件 ， 从 其 中 的 文 
件 名 你 或 许可 以 猜 到 这 些 吧 ) 。 





Fi = RT SO 





传统 的 Hibernate 使 用 XML 文档 来 维护 Java 类 和 关系 数据 库 表 之 间 的 
映射 关系 。 这 种 映射 文档 设计 为 可 由 开发 人 员 阅 读 和 手工 编辑 的 。 你 也 
可 以 用 图 形 化 的 CASE (Computer Aided Software Engineering， 计 算 机 
辅助 软件 工程 工具 (例如 Togethor (H) . Rose (P1) 以 及 
Poseidon (1) ) 来 建立 表示 数据 模型 的 UML 图 表 ， 再 将 这 些 图 表 输入 
到 AndroMDA ('4!) (http://www.andromda.org/) 中 ， 就 可 以 生成 相应 
的 Hibernate 映 射 文档 。 前 面 提 到 的 Hibernate Tools 包 也 可 以 为 你 提供 这 


些 功能 〈 第 11 章 将 会 演示 在 Eclipse 中 使 用 它们 是 多 么 容易 ) 。 





要 牢记 ，Hibernate 及 其 扩展 工具 可 以 让 你 用 其 他 方式 进行 开发 。 如 
果 你 已 经 有 了 Java 类 或 数据 ， 也 可 以 从 它们 开始 着 手 。 我 们 还 会 学 习 一 
种 更 新 的 方法 一 Hibernate 标 注 ， 它 可 以 让 你 完全 脱离 开 XML 了 映射 文档 ， 





这 种 方法 将 在 第 7 章 加 以 介绍 。 


这 里 ， 我 们 先 手 工 编写 XML 了 映射 文档 ， 这 是 一 种 相当 实用 的 方 
法 。 我 们 要 为 曲目 (Track)〉 对 象 创建 映射 文件 。 曲 目 就 是 各 个 可 以 单 
独 欣 贫 的 乐曲 ， 或 是 可 以 收录 在 乐曲 集 或 演 委 列表 中 的 乐曲 。 首先 ， 我 
们 要 记录 曲目 的 标题 、 存 储 实际 音乐 的 文件 路 径 、 它 的 播放 时 间 、 曲 目 
添加 进 数 据 库 的 日 期 以 及 播放 曲目 应 该 用 的 音量 不同 乐曲 在 录制 时 采 
用 的 音量 不 见得 相同 ， 总 用 预 设 的 默认 音量 播放 不 一 定 合适 ) 。 














为 什么 选择 这 个 示例 








你 可 能 根本 不 需要 创建 一 个 新 的 系统 来 保存 音乐 曲目 ， 但 在 建立 这 
个 示例 的 映射 文档 时 所 涉及 的 概念 和 处 理 过 程 ， 可 以 在 你 的 实际 项 目 中 
加 以 应 用 。 








应 该 怎么 做 


注意 : 你 可 能 会 觉得 这 一 映射 文件 中 包含 了 太 多 的 信息 。 正 如 你 所 
看 到 的 ， 确 实 如 此 ， 可 以 用 它 来 创建 很 多 有 用 的 项 目 资源 。 





打开 你 喜欢 用 的 文本 编辑 器 ， 在 前 面 1.7 节 中 创建 的 
src/com/oreilly/hh/data 目 录 下 创建 一 个 名 为 Track.hbm.xml 的 文件 (如 果 
你 跳 过 了 这 一 节 ， 就 得 回去 再 阅读 一 下 1.7 节 ， 因 为 本 示例 要 依赖 当时 








所 建立 的 项 目 目录 结构 和 工具 ) 。 在 该 映射 文档 中 输入 例 2-1 所 示 的 内 


ZJN 


fe) 





例 2-1: 曲目 对 象 的 映射 文档 : Track.hbm.xml 





<?xml version="1.0"?> 

<! DOCTYPE hibernate-mapping PUBLIC"-//Hibernate/Hibernat 
Mapping DTD 3.0//EN" 

"http: //hibernate. sourceforge.net/hibernate-mapping-3.0.dtd">@ 

<hibernate-mapping> 

<class name="com.oreilly.hh.data.Track"table="TRACK" >@ 

<meta attribute="class-description">®@® 

Represents a single playable track in the music database. 

@author Jim Elliott (with help from Hibernate) 

</meta> 

<id name="id"type="int"column="TRACK ID">@ 

<meta attribute="scope-set">protected</meta> 

<generator class="native"/>@ 

</id> 

<property name="title"type="string"not-null="true"/>@ 

<property name="filePath"type="string"not-null="true"/> 

<property name="playTime"type="time">@ 





































































































<meta attribute="field-description">Playing time</meta> 

</property> 

<property name="added"type="date"> 

<meta attribute="field-description">When the track was created 
</meta> 


</property> 

<property name="volume"type="Short"not-null="true"> 

<meta attribute="field-description">How loud to play the track 
</meta> 

</property> 

</class> 

</hibernate-mapping> 























@ 最 前 面 的 3 行 是 有 效 的 XML 文 档 所 必需 的 预定 义 部 分 ， 用 于 声明 
该 XML 文档 符合 Hibernate 上 映射 使 用 的 文档 类 型 定义 。 实 际 的 映射 内 容 将 


位 于 hibernate-mapping 标 签 内 部 。 


四 我 们 正在 为 一 个 类 (com.oreilly.hh.data.Track) 定义 它 的 映射 ， 

这 个 类 的 名 称 和 包 名 与 已 经 创建 的 文件 的 名 称 和 路 径 是 一 致 的 。 但 这 种 
关系 不 是 必需 的 ， 可 以 在 一 个 映射 文档 中 为 任意 数量 的 类 定义 它们 的 映 
射 ， 为 映射 文件 起 任意 名 字 ， 并 把 它 放 在 任何 地 方 ， 只 要 告诉 Hibernate 
怎么 找到 这 个 文件 就 可 以 了 。 不 过 ， 根 据 映 射 到 的 类 来 命名 映射 文件 ， 
并 将 它 和 映射 到 的 类 放 在 一 起 ， 这 一 惯例 带 来 的 好 处 是 : 当 需 要 使 用 这 
个 类 时 ，Hibernate 能 够 自动 定位 该 映射 文档 。 当 类 的 数量 不 多 时 ， 这 样 
可 以 简化 Hibernate 的 配置 和 使 用 。 








如 果 映 射 类 的 数量 比较 多 ， 那 么 你 可 能 会 希望 使 用 XML 格式 的 
Hibernate 配 置 文件 ， 再 从 这 个 配置 文件 中 引用 所 有 的 映射 文档 ， 而 不 必 
像 本 书 第 1 版 那样 ， 在 所 有 示例 源 代码 中 再 涉及 它们 〈 从 下 一 章 开始 ， 
就 会 看 到 我 们 换 用 了 这 种 新 方法 ) 。 此 外 ， 在 使 用 基于 XML 的 配置 文 
件 时 ， 将 各 个 映射 文档 和 Hibernate 配 置 文件 放 在 一 起 ， 而 不 是 和 映射 类 
分 散 地 保存 ， 这 样 做 更 有 意义 。 


在 class 元 素 的 开始 标签 中 ， 我 们 指定 这 个 类 要 保存 在 一 个 名 为 
TRACK 的 数据 库 表 中 。 





@meta 标 签 并 不 会 直接 影响 映射 相反， 这 个 标签 为 使 用 其 他 不 同 
工具 而 提供 额外 的 信息 。 在 这 个 例子 中 ， 通 过 将 attribute 属 性 值 指定 
为 "class-description"， 我 们 告诉 Java 代 码 生 成 工具 : 需要 为 Track 类 关联 
什么 样 的 JavaDoc 文 本 信息 。 这 个 标签 完全 是 可 选 的 ， 在 本 章 稍 后 的 “后 








成 Java 类 ”一 节 中 ， 就 会 看 到 包含 JavaDoc 信 息 的 结果 。 


@@ 了 映射 内 容 的 其 他 部 分 用 于 设 定 我 们 想 保 存 到 数据 库 中 的 信息 ， 也 
就 是 类 的 属性 以 及 数据 库 表 中 与 之 相关 的 字段 。 虽 然 我 们 在 介绍 这 个 例 
子 时 没有 提 及 ， 但 每 个 曲目 对 象 都 需要 一 个 id 属性 。 按 照 数 据 库 的 最 佳 
实践 标准 ， 我 们 应 该 用 一 个 没有 意义 的 代理 键 (surrogate key， 一 个 没 
有 语义 含义 的 值 ， 只 用 来 标识 特定 的 数据 行 )。 在 Hibernate 中 ， 
key/id《〈 键 /属性 ) 之 间 的 映射 关系 是 用 id 标签 来 设置 的 。 我 们 准备 使 用 
一 个 int 类 型 的 值 把 id 保存 在 数据 库 字 段 Track_id 中 。 这 里 又 包含 了 一 个 
meta 标 签 ， 用 于 和 Java 代 码 生成 费 进 行 通 信 ， 告 诉 它 这 个 id 属 性 的 set 方 
法 应 该 具有 protected 类 型 的 访问 权限 ， 因 为 应 用 程序 代码 本 身 没有 必要 
去 修改 曲目 对 象 的 ID。 


@generator 标 签 用 于 设置 Hibernate 如 何 为 新 的 实例 创建 其 id 值 ( 注 
意 ， 该 标签 与 普通 的 对 象 /关系 映 映 操 作 有 关 ， 而 与 Java 代 码 生 成 器 无 
关 ， 而 且 也 不 经 常 使 用 代码 生成 嚣 ;，generator 要 比 可 选 的 meta 标 签发 挥 
更 多 的 功能 ) 。 在 这 个 标签 中 可 以 从 中 选择 很 多 不 同 的 ID 生成 策略 ， 甚 
至 可 以 编写 自己 的 策略 。 在 这 个 例子 中 ， 我 们 告诉 Hibernate 使 用 底层 数 
据 库 最 自然 的 主键 生成 方法 〈 稍 后 我 们 会 看 到 Hibernate 如 何 知 道 我 们 正 
在 使 用 什么 数据 库 ) 。 在 HSQLDB 中 ， 会 采用 一 个 标识 〈identity) F 
FX. 





@ 在 ID 之 后 ， 我 们 只 列举 出 关心 的 各 种 曲目 属性 。tite 是 一 个 字符 


串 属性 ， 而 且 不 能 为 null。filePath 也 有 同样 的 属性 设置 ， 而 除了 volume 
以 外 ， 其 他 属性 都 可 以 为 null。 


@playTime 是 time 类 型 ，added 是 date 类 型 ， 而 volume 是 short 类 型 。 
最 后 三 个 属性 用 了 另 一 个 新 的 meta 属 性 "field-description"， 用 它 为 单个 
属性 指定 JavaDoc 文 本 信息 ， 但 目前 的 代码 生成 器 对 此 还 有 些 限制 。 





该 映 冉 文件 严格 而 简练 地 指定 了 我 们 需要 表达 的 音乐 曲目 的 各 种 数 
据 ， 而 且 Hibernate 也 可 以 处 理 这 种 映射 格式 。 接 下 来 我 们 就 看 看 
Hibernate 实 际 上 是 如 何 处 理 的 〈Hibernate 能 够 表示 更 为 复杂 的 信息 ， 包 
括 表 示 对 象 之 间 的 关系 ， 我 们 将 在 接 下 来 的 几 章 中 加 以 介绍 。 附 录 E 也 
讨论 了 一 些 与 深入 学 习 本 书 内 容 相关 的 方法 ) 。 


[1] http://www.borland.com/us/products/together/index.html. 
[2] http://www-306.ibm.com/softwate/awdtools/developer/thechnical/. 
[3] http://genteware.com/index.php. 


[4] http://www.andromda.org/. 


生成 Java 类 


我 们 的 映射 文件 中 包含 的 是 有 关 数 据 库 、Java 类 以 及 它们 之 间 的 映 
射 关 系 的 信息 。 可 以 用 它 来 帮助 我 们 创建 数据 库 表 和 Java 类 。 首 先 ， 我 
们 来 看 看 Java 类 。 


应 该 怎么 做 


你 在 第 1 章 安 装 的 Hibernate Tools 中 包含 一 个 工具 ， 可 以 生成 匹配 映 
射 文档 规定 的 Java 源 代码 。 只 要 用 一 个 Ant 任 务 就 能 方便 地 在 Ant 的 构建 
文件 中 调用 这 一 工具 。 编 辑 build.xml， 把 例 2-2 中 的 黑体 部 分 添加 进去 。 





例 2-2: Ant 构 建文 件 (已 经 为 生成 Java 代 人 码 而 做 了 相应 的 更 新 ) 





<?xml version="1.0"?> 

<project name="Harnessing Hibernate 3 (Developer's Notebook 
Second Edition) " 

default="db"basedir="." 

xmins: artifact="antlib: org.apache.maven.artifact.ant"> 

































































<! --Set up properties containing important project directories-- 
> 

<property name="source.root"value="srce"/> 

<property name="class.root"value="classes"/> 

<property name="data.dir"value="data"/> 

<artifact: dependencies pathId="dependency.class.path"> 

<dependency groupid="hsqldb"artifactId="hsqldb"version="1.8.0.7"/ 
> 

<dependency groupId="o0rg.hibernate"artifactId="hibernate" 


version="3.2.5.ga"> 
<exclusion groupId="javax.transaction"artifactId="jta"/> 
</dependency> 





























<dependency groupId="org.hibernate"artifactId="hibernate-tools" 
version="3.2.0.beta9a"/> 

<dependency groupId="o0rg.apache.geronimo.specs" 
artifactId="geronimo-jta_1.1 spec"version="1.1"/> 

<dependency groupId="log4j"artifactId="log4j"version="1.2.14"/> 
</artifact: dependencies> 









































<! --Set up the class path for compilation and execution--> 
<path id="project.class.path"> 
<!--Include our own classes, of course--> 








<pathelement location="S${class.root}"/> 
<! --Add the dependencies classpath--> 
<path refid="dependency.class.path"/> 
</path> 
<! --Teach Ant how to use the Hibernate Tools--> 
<taskdef name="hibernatetool"@ 
classname="org.hibernate.tool.ant.HibernateToolTask" 
classpathref="project.class.path"/> 
<target name="db"description="Runs HSQLDB database management UI 
against the database file--use when application is not running"> 
<java classname="org.hsqldb.util.DatabaseManager" 
fork="yes"> 
<classpath refid="project.class.path"/> 
<arg value="-driver"/> 
<arg value="org.hsqldb.jdbcDriver"/> 
<arg value="-url"/> 
<arg value="jdbc: hsqldb: S{data.dir}/music"/> 
<arg value="-user"/> 
<arg value="sa"/> 
</java> 
</target> 
<!--Generate the java code for all mapping files in our source 
tree--> 
<target name="codegen"@ 
description="Generate Java source from the O/R mapping files"> 
<hibernatetool destdir="${source.root}"> 
<configuration> 
<fileset dir="S${source.root}"> 
<include name="**/* .hbm.xm1l"/> 
</fileset> 
</configuration> 
<hbm2java/> 
</hibernatetool> 
</target> 
</project> 


二 一 














































































































我 们 在 构建 文件 中 新 添加 了 一 个 taskedf 〈 任 务 定义 ) 元 素 ， 以 及 一 
个 用 于 创建 文件 的 target 元 素 : 


各 这 一 行 的 任务 定义 教 给 Ant 一 个 新 技巧 : 它 告 诉 Ant 如 何 使 用 
Hibernate Tools 中 包含 的 hibernate tool 任 务 (有 个 专门 的 类 为 该 目的 提供 
帮助 ) 。 注 意 ， 它 也 指定 了 调用 这 个 工具 时 所 需 的 类 路 径 ， 并 引用 
project.calss.path 定 义 〈 这 个 定义 包含 了 Maven Ant Tasks 为 我 们 管理 的 所 
有 依赖 文件 ) 。 当 Ant 需 要 使 用 hibernate 工 具 时 ， 通 过 这 种 办 法 ， 就 可 
以 找到 它们 。 


@codegen 构 建 目标 使 用 Hibernate Tools (hbm2java) 模式 来 运行 
Hibernate 的 代码 生成 器 ， 处 理 src 源 代码 目录 中 找到 的 任何 映射 文件 ， 生 
成 相应 的 Java 源 代码 。"**/*.hbm.xml" 这 样 的 匹配 模式 (pattem) 是 
说 “在 指定 目录 或 其 任何 子 目 录 下 无论 有 多 深 ) ， 任 何以 .hbm.xml 结 
尾 的 文件 ”。 





让 我 们 先 试 一 下 吧 ! 从 你 的 项 目 目 录 的 命令 行 中 ， 输 入 以 下 命令 : 


ant codegen 





你 应 该 看 到 类 似 以 下 内 容 的 输出 假设 你 运行 过 前 面 划 节 中 ant db 
示例 ， 运 行 那个 例子 会 下 载 所 有 必需 的 依赖 文件 ， 如 果 你 还 没有 运行 过 
那个 例子 ， 则 此 时 在 下 载 这 些 依赖 文件 时 ， 会 多 显示 许多 行 信息 ) : 





Buildfile: build.xml 

codegen: 

[hibernatetool]Executing Hibernate Tool with a Standard 
Configuration 
[hibernatetool]l.task: hbm2java (Generates a set of.java files) 
[hibernatetool]log4j: WARN No appenders could be found for logger 
Corg.hibernate.cfg.Environment) . 
[hibernatetool]log4j: WARN Please initialize the log4j system 
properly. 
BUILD SUCCESSFUL 
Total time: 2 seconds 


































































































以 上 提示 信息 大 致 说 的 是 ， 我 们 在 第 1 章 配 置 构建 文件 要 安装 
log4j， 但 还 没有 建立 它 需 要 的 配置 文件 ， 我 们 将 在 2.3 节 介绍 解决 这 一 
问题 的 办 法 。 现 在 ， 如 果 你 去 看 看 src/com/orielly/hh/data 目 录 ， 就 会 发 
现 出 现 了 一 个 名 为 Track.java 的 新 文件 ， 其 内 容 如 例 2-3 所 示 。 


例 2-3: 根据 Track 映射 文档 生成 的 Java 源 代码 





package com.oreilly.hh.data; 

//Generated Sep 2, 2007 10: 27: 53 PM by Hibernate Tools 3.2.0.b9 
import java.util.Date; 

/** 

*Represents a single playable track in the music database.@ 
*@author Jim Elliott (with help from Hibernate) 

xx / 

public class Track implements java.io.Serializable{ 

© 

private int id; 

private String title; 

private String filePath; 









































/** 

*Playing time 

ee 

private Date playTime; 

/** 

*When the track was created 
ate 

private Date added; 


/** 


*How loud to play the track 
ad 
private short volume; 
© 
public Track O { 
} 
public Track (String title, String filePath, short volume) { 
this.title=title; 
this.filePath=filePath; 
this.volume=volume; 
} 
public Track (String title, String filePath, Date playTime, Date 
added, 
short volume) { 
this.title=title; 
this.filePath=filePath; 
this.playTime=playTime; 
this.added=added; 
this.volume=volume; 
} 
public int getId © { 
return this.id; 
} 
protected void setId (int id) 10 
this.id=id; 
} 
public String getTitle © { 
return this.title; 
} 
public void setTitle (String title) { 
this.title=title; 
} 
public String getFilePath () { 
return this.filePath; 
} 
public void setFilePath (String filePath) { 
this.filePath=filePath; 
} 
/** 
**Playing time 
E7 
public Date getPlayTime () { 
return this.playTime; 
} 
public void setPlayTime (Date playTime) { 
this.playTime=playTime; 
} 
/** 





























































































































**When the track was created 

ay 

public Date getAdded () { 

return this.added; 

} 

public void setAdded (Date added) { 
this.added=added; 

} 


/** 

xxHow loud to play the track 
xj 

public short getVolume () { 





return this.volume; 
} 
public void setVolume (short volume) { 
this.volume=volume; 

} 

} 














这 个 文件 是 怎么 生成 的 ?Ant 会 找 出 源 代码 树 中 所 有 以 .hbm.xml 结 
尾 的 文件 《目前 只 有 一 个 ) ， 把 它们 传 给 Hibernate 的 代码 生成 器 ， 该 代 
码 生 成 器 会 分 析 映 射 文件 ， 并 生成 一 个 满足 Track 映射 文件 中 指定 映射 
要 求 的 Java 类 文件 。 很 明显 ， 这 个 工具 可 以 为 我 们 市 省 很 多 时 间 ， 并 帮 
我 们 完成 一 些 重 复 性 的 工作 ! 





注意 : Hibernate 可 以 为 我 们 节省 许多 时 间 并 完成 很 多 繁琐 的 操作 。 
BANK, BAI ESOC TET eA A 


比较 生成 的 Java 源 代码 和 映射 文件 中 的 映射 规定 《〈“ 例 2-1) ， 你 会 有 
所 收获 。 源 代码 以 相应 的 包 Cpackage) 声明 作为 开始 ， 对 于 hbm2java 
而 言 ， 根 据 映 射 文件 中 指定 的 完全 限定 的 类 名 ， 残 可 以 容易 地 确定 正确 
的 包 名 : 





ORAiNJavaDocH ERMIR. AER BB SC meta 


标签 的 "class-description"。 





印字 段 声 明 是 来 自 于 映射 文档 中 定义 的 id 和 property 标 签 。 源 代码 中 
所 用 到 的 Java 类 型 都 是 源 目 于 映射 文档 中 的 property 类 型 声明 。 学 习 有 关 
Hibernate 文 持 的 全 部 值 类 型 ， 可 以 参阅 附录 E 提 到 的 资源 。 目 前 而 言 ， 
映射 文件 内 的 类 型 和 已 生成 的 代码 内 的 Java 类 型 两 者 间 的 关系 应 该 相当 
明确 。 





全 字段 声明 之 后 是 三 个 构造 函数 的 定义 。 第 一 个 构造 函数 是 创建 实 
例 时 不 用 任何 参数 (如 果 想 让 你 的 类 能 够 作为 标准 的 bean 来 使 用 ， 例 如 
在 JSP (Java Server Page) 内 使 用 ， 这 是 这 种 数据 类 非常 第 见 的 用 
法 ) ; 第 二 个 构造 函数 只 需要 提供 映射 文档 中 标明 不 得 为 null 的 值 ， 最 
后 一 个 构造 函数 是 为 所 有 属性 赋值 。 注 意 ， 这 些 构造 函数 都 没 设置 id 属 
性 的 值 ， 当 我 们 从 数据 库 把 对 象 取出 或 者 第 一 次 将 对 象 数据 插入 数据 库 
时 ，Hibernate 负 责 帮 我 们 做 这 件 事 。 





OF, seld O 方法 的 访问 类 型 是 protected， 与 id 的 映射 配置 的 
要 求 是 一 样 的 。 后 面 的 getter 和 setter 方 法 就 没什么 特别 之 处 了 ， 都 是 些 
照 本 宣 科 式 的 程序 代码 〈 我 们 都 写 过 无 数 次 了 ) ， 这 就 是 让 Hibernate 工 
具 为 我 们 生成 这 些 代码 的 妙 处 所 在 。 


如 果 你 想 使 用 Hibernate 生 成 的 代码 作为 起 点 ， 并 在 生成 的 Java 类 中 


添加 某 些 业务 逻辑 或 其 他 功能 ， 一 定 要 记 住 ， 你 所 做 出 的 修改 在 下 一 次 
运行 代码 生成 器 时 ， 都 会 被 “悄悄 ”地 丢弃 。 在 这 样 的 项 目 中 ， 你 需要 确 
保 手工 修改 过 的 类 不 会 被 任何 Ant 的 构建 目标 任务 重新 生成 。 一 种 常用 
的 技巧 是 ， 把 需要 手工 修改 的 类 扩展 成 Hibernate 生 成 的 类 。 这 也 是 为 什 
么 我 们 要 将 映射 生成 的 Java 类 隅 离 到 它们 上 自己 的 代码 包 和 子 目 录 中 的 原 
AlZ—. 





虽然 此 例 中 Hibernate 为 我 们 生成 了 数据 类 ， 但 需要 指出 的 一 个 要 点 
是 ，Hibernate 创 建 的 getter 和 setter 方 法 不 仅仅 是 为 了 样子 好 看 。 对 于 你 
需要 持久 化 的 任何 属性 ， 在 持久 类 中 都 必须 具有 getter 和 setter 方 法 。 这 
是 因为 Hibernate 底 层 的 持久 化 架构 是 通过 反射 机 制 来 访问 JavaBeans 风 格 
的 属性 的 。 如 果 你 不 希望 类 的 属性 是 公共 (public〉 的 ， 它 们 可 以 不 必 
是 public 的 《即使 属性 被 声明 为 protected 或 private, Hibernate 还 是 有 办 法 
取得 这 些 属 性 的 值 ) ， 但 它们 必须 具有 访问 器 和 修改 器 方法 ， 即 
getter CO EJA) 和 setter〈 修 改 器 ) 方法 。 这 一 点 也 是 优秀 的 面向 对 象 
设计 应 该 遵循 的 准则 Hibernate 团队 希望 把 实际 的 实例 变量 Cinstance 
variable) 的 实现 细节 与 底层 持久 化 保存 机 制 完 全 分 离开 来 。 








编制 数据 库 Schema 








刚才 真 简单 ， 对 吧 ? 根据 映射 来 创建 数据 库 表 也 差不多 是 这 样 ， 你 
会 很 愉快 地 学 习 下 去 。 和 代码 生成 一 样 ， 只 要 利用 映射 文件 ， 几 乎 所 有 
工作 都 做 完了 。 剩 下 的 就是 设置 和 运行 Schema 生 成 工具 。 


应 该 怎么 做 





第 一 步 是 我 们 在 第 1 章 间 接 提 到 的 一 些 事情 。 我 们 必须 告诉 
Hibernate， 我 们 要 使 用 什么 数据 库 ， 这 样 ，Hibernate 才 知道 应 该 使 用 什 
么 SQL“ 方 言 ”(dialect) 。 没 错 ，SQL 是 标准 ， 但 每 种 数据 库 系 统 在 标 
准 SQL 基础 上 ， 还 都 有 各 自在 某 些 方面 的 扩展 ， 有 一 套 会 影响 到 实际 应 
用 的 特定 功能 和 限制 。 为 了 解决 这 一 现实 问题 ，Hibernate 提 供 了 一 组 类 
来 封装 常见 数据 库 环 境 的 独特 功能 ， 这 些 类 位 于 org.hibernate.dialect 包 
中 。 你 只 需要 告诉 Hibernate 想 要 使 用 哪 一 种 数据 库 〈 如 果 你 要 使 用 的 数 
据 库 是 Hibernate 目 前 尚未 支持 的 ， 也 可 以 自行 实现 必需 的 SQL 方言 ) 。 





在 我 们 的 这 个 例子 中 ， 使 用 的 是 HSQLDB 数 据 库 ， 所 以 要 用 
HSQLDialect。 配 置 Hibernate 最 简单 的 方法 就 是 创建 一 个 名 为 
hibernate.properties 的 属性 配置 文件 ， 再 将 它 放 在 项 目 类 路 径 的 根 目录 
中 。 在 src 目 录 的 顶层 创建 这 个 文件 ， 将 例 2-4 的 内 容 放 进 去 。 


例 2-4: 设置 hibernate.properties 的 内 容 








hibernate. dialect=org.hibernate.dialect.HSQLDialect 
hibérnate.connection.driver class=org.hsqldb.jdbcDriver 
hibernate.connection.url=jdbc: hsgldb: data/music 
hibernate. connection.username=sa 

hibernate. connection. password= 

hibernate. connection. shutdown=true 














除了 设置 要 使 用 的 SQL 方言 以 外 ， 这 个 属性 配置 文件 也 会 告诉 
Hibernate 如 何 使 用 封装 在 HSQLDB 数 据 库 JAR 文 件 内 的 JDBC 驱 动 程序 来 
建立 数据 库 的 连接 ， 而 且 数 据 应 该 放 在 data 目 录 下 名 为 music 的 数据 库 
中 。 在 经 过 第 1 章 的 实践 以 后 ， 对 用 户 名 和 空 密码 (事实 上 ， 所 有 都 是 
这 个 值 ) 应 该 都 很 熟悉 了 。 最 后 ， 我 们 告诉 Hibernate， 当 处 理 完成 后 ， 
应 该 显 式 关闭 数据 库 连 接 ， 这 是 在 坐 入 模式 下 处 理 HSQLDB 的 一 个 
artifact。 如 果 不 关 闭 连接 的 话 ， 当 工具 退出 时 ， 对 数据 库 的 修改 就 不 一 
定 会 写 入 到 数据 库 中 ， 所 以 你 的 数据 库 模式 总 是 莫名 其 妙 地 为 空 




















如 前 所 述 ， 你 也 可 以 使 用 XML 格式 来 保存 配置 信息 ， 但 就 此 处 的 
简单 需求 而 言 ， 这 样 做 没有 什么 价值 。 我 们 将 在 第 3 章 介 绍 XML 格 式 的 
配置 方法 。 


你 也 可 以 把 .properties 文 件 存 放 在 其 他 地 方 ， 并 提供 不 同 的 文件 名 
称 ， 或 者 以 完全 不 同 的 方式 把 这 些 设置 属性 传递 给 Hibernate。 但 这 里 是 
Hibernate 寻 找 配置 文件 的 默认 位 置 ， 因 此 这 是 个 最 方便 的 路 径 〈 或 者 ， 
我 猜想 也 是 需要 最 少 运行 时 配置 的 方法 ) 。 











我 们 也 需要 在 Ant 构 建文 件 中 加 入 一 些 新 项 ， 如 例 2-5 所 示 ， 在 
build.xml 文 件 末 尾 的 二 /project 二 结束 标签 前 增加 了 一 些 新 的 目标 。 


例 2-5: 生成 schema 所 需要 的 Ant 构 建文 件 





<! --Create our runtime subdirectories and copy resources into 
them-- > 

<target name="prepare"description="Sets up build structures">@ 

<mkdir dir="S{class.root}"/> 

<! --Copy our property files and O/R mappings for use at runtime- 
-> 

<copy todir="S{class.root}"> 

<fileset dir="S${source.root}"> 

<include name="**/*.properties"/> 

<include name="**/*.xml"/>@ 

</fileset> 



































</target> 

<! --Generate the schemas for all mapping files in our class 
tree--> 

<target name="schema"depends="prepar "® 

description="Generate DB schema from the O/R mapping files"> 

<hibernatetool destdir="${source.root}"> 

<configuration> 

<fileset dir="S{class.root}"> 

<include name="**/* ,hbm.xm1l"/> 

</fileset> 

</configuration> 

<hbm2ddl drop="yes"/>@ 

</hibernatetool> 

</target> 





















































四 首先 ， 我 们 加 了 一 个 prepare 构 建 目标 ， 以 供 其 他 构建 目标 使 用 ， 
而 不 是 从 命令 行 直接 调用 。 其 用 途 是 在 必要 时 创建 classes 目 录 ， 以 便 将 
编译 好 的 Java 代 码 放 在 这 个 目录 中 ， 再 把 src 目 录 中 找到 的 任何 .properties 
文件 和 映射 文件 都 复制 到 对 应 目录 的 classes 层 。 这 种 层次 式 的 复制 是 








Ant 相 当 棒 的 功能 〈 使 用 特殊 的 “**y/*>” 匹 配 模 式 ) ， 让 我 们 可 以 定义 和 编 
辑 源 代码 文件 会 使 用 到 的 相关 资源 ， 同 时 在 运行 时 通过 类 加 载 嚣 (class 
loader) 来 使 用 这 些 资源 。 


多 这 一 设置 会 让 Ant 复 制 所 有 找到 的 XML 文件 ， 而 不 仅仅 是 映射 文 
档 。 虽 然 我 们 现在 还 不 需要 这 样 的 配置 文件 ， 但 以 后 当 我 们 切换 到 基于 
XML 的 Hibernate 配 置 文件 时 ， 这 一 设置 加 显 得 很 重要 了 。 








@schema 构 建 目标 需要 依赖 prepare 构 建 目标 ， 让 它 把 映射 文档 复制 
到 正确 的 位 置 以 供 运 行 时 使 用 。 它 会 用 hbm2ddl 模 式 来 调用 Hibernate 工 
具 ， 让 它们 为 在 classes 目 录 中 找到 的 任何 映射 文档 生成 相应 的 数据 库 模 
式 〈 如 前 所 述 ， 在 下 一 章 我 们 使 用 功能 更 强大 的 Hibernate XML 配置 文 
件 时 ， 这 样 就 会 更 简单 些 ) 。 








全 可 以 为 schema 生 成 工具 指定 很 多 参数 ， 以 配置 其 工作 方式 。 在 这 
个 例子 中 ， 我 们 告诉 schema 生 成 工具 在 根据 映射 文档 生成 新 的 数据 表 定 
义 之 前 ， 先 删除 原来 可 能 已 经 存在 的 〈drop=yes) 。 有 关 这 一 配置 和 其 
他 配置 选项 的 更 多 细节 ， 可 以 查阅 Hibernate Tools 参 考 手 册 。Hibernate 
甚至 可 以 检查 现 有 的 数据 表 ， 并 尝试 计算 出 如 何 修改 schema， 才 能 反映 
出 新 映射 文件 的 变化 。 








在 添加 了 这 些 内 容 以 后 ， 就 可 以 准备 为 我 们 的 TRACK 表 生 成 数据 
库 schema 了 。Hibermnate 可 以 为 实现 我 们 的 目标 而 完成 许多 奇特 的 操作 ， 


并 井然 有 序 地 完成 处 理 。 我 们 只 需要 为 一 定 的 消息 配置 好 日 志 处 理 ， 就 
可 以 很 容易 地 观察 到 Hibernate 进 行 的 操作 过 程 。 为 此 ， 我 们 需要 配置 

Log4j， 这 是 Hibernate 所 使 用 的 日 志 处 理 环境 。 最 简单 的 配置 方法 是 直 
接 在 类 路 径 下放 一 个 log4j.properties 文 件 。 我 们 可 以 利用 现 有 的 prepare 
target， 在 Ant 复 制 Hibernate 的 .properties 文 件 时 ， 顺 便 将 log4j.properties 

文件 从 src 目 录 复 制 到 classes 目 录 。 





在 src 目 录 下 创建 一 个 名 为 log4j.properties 的 文件 ， 内 容 如 例 2-6 所 
示 。 《一 种 简单 的 做 法 就 是 从 你 下 载 的 Hibernate 有 发行 包 中 的 
doc/tutorial/src 目 录 将 这 个 文件 复制 出 来 ， 因 为 该 文件 就 是 给 Hibernate 发 
行 包 所 带 的 示例 使 用 的 。 如 果 你 自己 输入 ， 则 可 以 跳 过 注释 块 的 内 容 ， 
它们 只 是 介绍 一 些 有 用 的 日 志 功 能 的 其 他 选项 。) 





例 2-6: log4j.properties 日 志 配 置 文件 





###direct log messages to stdout### 
log4j.appender.stdout=org.apache.log4j.ConsoleAppender 




























































































log4j.appender.stdout.Target=System.out 

log4j.appender.stdout.layout=org.apache.log4).PatternLayout 

log4j.appender.stdout.layout.ConversionPattern=%d {ABSOLUTE} %5p%Sc{1 
S$L-Smon 

###direct messages to file hibernate. log### 

#1log4j.appender.file=org.apache.1log4j.FileAppender 

#log4j.appender.file.File=hibernate.log 

#1og4j.appender.file.layout=org.apache.log4j.PatternLayout 

#1log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} S5p%c{1} 
S$L-Smon 

###set log levels-for more verbose logging 














change'info'to'debug'### 
log4j.rootLogger=warn, stdout 
log4j.logger.org.hibernate=info 
#log4j.logger.org.hibernate=debug 





























# g HOL query parser activity 

#1 j.logger.org.hibernate.hgql.ast.AST=debug 
###1log just the SQL 
#1 j 
# g 

















.lLogger.org.hibernate.SQL=debug 
JDBC bind parameters### 
log4j.logger.org.hibernate.type=info 





































































































#log4j.logger.org.hibernate.type=debug 

###1log schema export/update### 
log4j.logger.org.hibernate.tool.hbm2ddl=debug 
###log HOL parse trees 
#10g4j.logger.org.hibernate.hql=debug 

###log cache activity### 
#log4j.logger.org.hibernate.cache=debug 
###log transaction activity 
#1og4j.logger.org.hibernate.transaction=debug 
###log JDBC resource acquisition 
#log4j.logger.org. hibernate. jdbc=debug 
###enable the following line if you want to track down 

















connection### 
###leakages when using DriverManagerConnectionProvider### 
#1og4j.logger.org.hibernate.connection.DriverManagerConnectionProv 














有 了 日 志 配 置 文件 以 后 ， 你 可 能 会 想 编辑 build.xml 中 的 codegen 目 
标 ， 使 其 也 依赖 于 新 的 prepare 目 标 。 这 样 可 以 确保 无 论 何 时 调用 
codegen， 都 配置 了 日 志 处 理 ， 而 且 Hibernate 配 置 也 可 以 使 用 ， 消 除了 
我 们 第 一 次 使 用 它 时 的 麻烦 。 


现在 可 以 制作 数据 库 模式 了 ! 在 项 目 目录 的 命令 行 下 ， 执 行 命令 
ant prepare， 接 着 再 执行 ant schema. 你 会 看 到 类 似 例 2-7 内 容 的 输出 ， 
同时 还 会 创建 classes 目 录 ， 并 在 其 中 生成 了 各 种 资源 文件 ， 再 接着 就 会 
运行 模式 生成 器 (schema generator) 。 








例 2-7: 使 用 HSQLDB 的 骨 入 式 数 据 库 服务 器 来 建 并 数据 库 模式 





Sant prepare 








Buildfile: build.xml 





prepare: 
[mkdir]Created 


dir: 


ch02/classes 


[copy]Copying 3 





examples/ch02/classes 





BU 








ILD SUCCI 
Total time: 





ESSFUL 
0 seconds 


Sant schema 








Buildfile: build.xml 





prepare: 


schema: 





Conf 


s5 





properties 


[hiberna 
iguration 
[hiberna 
[hiberna 


[hiberna 
from reso 





Ce 





too] 








Le 


tool] 





Le 





tool]22: 38: 21, 858 





NFO 


/Users/jim/svn/oreilly/hib dev_2e/current/examples/ 


files to/Users/jim/svn/oreilly/hib dev_2e/current/ 


JExecuting Hibernate Tool with a Standard 


1.task: hbm2ddl (Generates database schema) 
Environment: 


514-Hibernat 


























Ee 





tool]22: 38: 21, 879 





UES 





hibernat 


hibernate.properties: 
.connecti 





on 
hibern 





.password=* 
.dialect=org.hibernate.dialect.HSQLDialect, hibernate. 


KRR 
$ 








at 


connection.shutdown=true, 
data/music, 
rnate.bytecod 


hibe 











hibern 


.US T 








ate.connection.driver class 


=org.hsqldb.jdbcDriver} 


[hibernatetool]22: 38: 21, 897 








NFO 


Environment: 





532-loaded 








provider name: cg 


lib 


[hibernatetool]22: 38: 21, 


java.sql.Time 
stamp handling 
[hibernatetool]22: 38: 22, 108 


930 








From 


Fil 








mappings 
e: 


/Users/j 





NFO 





f{hibernate.connection.username=sa, 


hibernate.connection.url=jdbc: hsqldb: 





flection optimizer=false, 














NFO 





Environment: 681-Bytecode 


Environment: 598-using JDK 1.4 





INFO Coni 








com/oreilly/hh/data/Track.hbm. xml 
[hibernatetool]22: 38: 22, 669 
com.oreilly.hh. 
data.Track->TRACK 
[hibernatetool]22: 38: 22, 827 


org.hibernate.di 





alect.HSQLDialect 


[hibernatetool]22: 38: 23, 





186 


hbm2ddl schema exp 


ort 














figuration: 299-Reading 


im/Documents/Work/OReilly/svn hibernate/current/example: 


INFO HbmBinder: 300-Mapping class: 


INFO Dialect: 152-Using dialect: 





INFO SchemaExport: 154-Running 


[hibernatetool]22: 38: 23, 





not found: /im 
port.sql 
[hibernatetoo 
generated schema 
to database 


[hiberna 

















GS 


tool 


1)22: 38: 23, 


]22: 38: 23, 


194 DEI 





T 





BUG SchemaExport: 170-import 





197 


232 








INFO SchemaE 





INFO 


DriverManagerConnectionProvider: 41-Using Hi 





DriverManagerConn 





[22% 383235 


234 


ectionProvider: 


e connection pool size: 20 























[hibernatetool]22: 38: 23, 241 
DriverManagerConnectionProvider: 

it mode: false 

[hibernatetool]22: 38: 23, 255 





bernate built-in connection pool (not 
[hibernatetool 





INFO 


42-Hibernat 





4 





INFO 
5-autocomm 


INFO 


DriverManagerConnectionProvider: 80-using dr 
iver: org.hsqldb.jdbcDriver at URL: jdbc: hsqldb: data/music 


[hibernatetool 
DriverManagerConn 
on properties: 
[hibernate 
[hibernate 
TRACK if exists; 
[hibernatetool 
fault as ide 


























de 





tool] 
tool] 


]22: 38: 23, 


{user=Sa, 


22: 38: 23, 





] create tabl 





ntity (start with 


258 


ectionProvider: 


le TRACK (TRACK_ 








1) » tit] 


e varchar (255) not null, 





INFO 


86-connecti 


password=****, 
drop table TRACK if 
945 DE 





T 











exists; 




















volume smallint not null, 


D 





T 


pe 


BUG SchemaExport: 303-create table 








varchar (255) not nul 
, playTime time, added date, 
key (TRACK ID) ) ; 
[hibernatetool]22: 38: 23, 951 
TRACK (TRACK _ 





ID integer generated by dei 





varchar (255) n 
ot null, 
date, volume sm 





fi] 











[hibernatetool 
complete 


[hiberna 


Ge 














tetool 


all 
int not null, primary key (TRACK 


]22: 38: 23, 


]22: 38: 23, 





981 


988 





ID integer 








file 





xport: 179-exporting 


for production use! ) 


shutdown=true } 





BUG SchemaExport: 303-drop table 


generated by 


filePath 





primary 








fault as identity (start with 1), title 





ePath varchar (255) not null, playTime time, added 





ID) ) ; 
INFO Schema! 








INFO 


DriverManagerConnectionProvider: 147-cleanin 
g up connection pool: jdbc: hsqldb: data/music 














Total time: 





BUILD SUCCESSFUL 
2 seconds 


Export: 196-schema export 


二 一 


在 模式 导出 〈schema export) 部 分 的 末尾 ， 你 能 够 看 到 Hibernate 用 
于 创建 TRACK 表 的 真实 SQL 语句 。 如 果 你 查看 data 目 录 下 music.script 文 
件 的 开头 部 分 ， 就 会 发 现 它 已 经 整合 到 数据 库 了 。 为 了 采用 更 友好 的 
(也 许 是 更 方便 的 ) 方式 来 查看 数据 ， 可 以 执行 ant db 来 启动 HSQLDB 
图 形 界 面 ， 如 图 2-1 所 示 。 





eee _ HSQL Database Manager 


日 jdbc:hsqidb: datasmusic 
E TRACK. 
schema: PUBLIC 
B TRACK_ID 
Type: INTEGER 
Nullable: false 
E TITLE 
Type: VARCHAR 
ullable; false 
& FILEPATH 
Type: VARCHAR 
Nullable: false 
B PLAYTIME 
Type: TIME 
Nullable: true 
B ADDED 
Type: DATE 
Nullable: true 
E YOLUME 
Type: SMALLINT 
Nullable: false 
Indices 
®© Properties 





图 2-1 显示 新 的 TRACK 表 的 内 容 以 及 一 个 查询 的 数据 库 管 理 器 界面 


细心 的 读者 可 能 会 问 ， 既 然 schema target 已 经 依赖 于 prepare 了 ， 那 


第 二 YY 


为 什么 要 调用 两 次 Ant， 第 一 次 是 运行 prepare， 第 二 次 是 运行 schema。 
这 是 一 种 所 谓 的 步步为营 法 (bootstrapping) 的 问题 ， 只 在 第 一 次 创建 
环境 时 才 会 遇 到 。 有 具体 问题 是 ，Ant 在 启动 时 会 处 理 属 性 定义 ， 以 决定 
项 目 类 路 径 的 内 容 。 直 到 prepare 至 少 运行 一 次 以 前 ，classes 目 录 还 不 存 
在 ， 也 不 会 包 售 hibernate.properties 文 件 ， 所 以 在 类 路 径 中 也 不 包含 这 个 
目录 。 在 prepare 运 行 以 后 ， 才 会 在 classes 目 录 生 成 这 个 文件 ， 而 classes 
目录 也 才 会 包含 在 类 路 径 中 。 但 是 Ant 在 下 一 次 运行 以 前 ， 不 会 重新 设 
置 属性 定义 。 所 以 ， 如 果 你 试图 在 第 一 次 Ant 运 行 时 就 运行 Schema 目 
标 ，Hibernate 就 会 出 现 异 常 ， 问 你 报告 没有 指定 一 个 数据 库 方 言 ， 因 为 
它 找 不 到 配置 属性 文件 。 这 种 问题 经 常会 导致 令 人 困惑 的 塌 傣 。 不 过 ， 
从 现在 起 ， 可 以 安全 地 直接 运行 schema 目 标 了 ， 并 通过 它 来 调用 
prepare， 按 照 需要 复制 新 版 本 的 属性 文件 ， 因 为 它们 在 Ant 开 始 运行 
时 ， 融 已 经 在 类 路 径 中 存在 了 。 





BHT APA St 


刚才 我 们 已 经 能 够 使 用 Hibernate 创 建 一 个 数据 表 了 ， 以 后 我 们 可 以 
将 Hibernate 为 我 们 创建 的 Java 类 实例 持久 地 保存 在 这 个 数据 表 中 。 我 们 
没有 输入 任何 一 行 SQL 或 Java 语 句 ! 当然 ， 我 们 的 数据 库 表 目 前 还 是 空 
的 。 来 改变 它 吧 ! 下 一 章 会 介绍 你 可 能 最 想 学 习 的 主题 ， 在 Java 程 序 中 
使 用 Hibernate 将 Java 对 象 转换 为 数据 库 中 的 数据 项 ， 并 进行 相反 的 转 








在 深入 探讨 那 种 非常 酷 的 任务 之 前 ， 我 们 应 该 再 回想 一 下 通过 一 些 
XML 和 .properties 文 件 所 能 做 到 的 诸多 事项 ， 这 是 非常 有 价值 鸭 。 斋 望 
你 已 经 开始 看 到 Hibernate 的 强大 功能 和 使 用 上 的 便利 了 。 





其 他 


其 他 ID 生成 方法 呢 ? 主键 Key) 在 整个 数据 库 中 或 全 世界 都 是 惟 
一 的 吗 ?Hibernate 文 持 很 多 为 存储 在 数据 库 中 的 对 象 选择 相应 的 主键 的 
方法 。 这 是 由 generator 标 签 控制 的 ， 如 例 2-1 的 第 5 行 所 示 。 在 这 个 示例 
中 ， 我 们 告诉 Hibernate， 对 其 遇 到 的 数据 库 类 型 使 用 最 自然 的 主键 生成 
方法 (native) 。 其 他 方法 还 包括 流行 的 "hi/lo" 算 法 、 全 局 UUID、 完 全 
由 Java 程 序 代码 诀 定 的 方法 以 及 其 他 多 种 方法 。 有 具体 细节 ， 可 以 参阅 
Hibernate 参 考 手 册 文 档 中 "Basic O/R Mapping" 那 一 章 的 "generator" 一 
节 。 此 外 ， 如 果 内 建 的 各 种 方法 都 满足 不 了 你 的 需要 《〈 时 常 如 此 ) ， 还 
可 以 提供 你 自己 的 类 来 做 你 想 做 的 事情 (实现 org.hibernate.id.Identifier- 
Generator 接 口 ， 再 把 实现 类 的 名 称 放 在 generator 标 签 内 ) 。 





如 果 你 想 学 习 一 下 用 Hibernate 连 接 你 所 更 熟悉 的 数据 库 的 示例 ， 可 
以 和 爷 看 看 第 10 蔓 ， 这 一 章 将 演示 如 何 用 Hibernate 处 理 MySQL 数 据 库 。 
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好 了 ， 通 过 前 两 章 的 学 习 ， 我 们 已 经 打 牢 了 基础 ， 定 义 好 对 象 / 关 
ARRAY Cobject/relational mapping) 后 ， 又 用 它 创 建 了 相 匹 配 的 Java 类 和 
数据 库 表 。 但 这 如 何 应 用 呢 ?” 现 在 就 介绍 一 下 用 Hibermate 在 Java 程 序 代 
人 码 中 人 处理 持久 化 (persistent)〉 数据 是 多 么 的 方便 。 


配置 Hibernate 


在 我 们 继续 学 习 Hibernate 的 使 用 之 前 ， 我 们 需要 解决 某 些 妨碍 继续 
前 进 的 问题 。 在 上 一 章 中 ， 我 们 使 用 src 目 录 下 的 hibernate.properties 文 件 
来 配置 Hibernate 的 JDBC 连 接 。 在 这 一 章 中 ， 我 们 将 使 用 Hibernate XML 
配置 文件 来 配置 JDBC 连 接 、SQL 方 言 等 各 种 Hibernate 设 置 。 与 
hibernate.properties 文 件 一 样 ， 我 们 也 把 这 个 XML 配置 文件 放 在 src 目 录 
中 。 将 例 3-1 的 内 容 输入 到 一 个 名 为 hibernate.cfg.xml 的 文件 中 ， 并 将 其 
保存 在 src 目 录 下 ， 再 删除 原来 的 hibernate.properties 文 件 。 


例 3-1: 用 XML 配置 Hibernate: hibernate.cfg.xml 








<?xml version="1.0"encoding="utf-8"?> 
<! DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://hibernate. sourceforge.net/hibernate-configuration- 
3.0.dtd"> 
<hibernate-configuration> 









































<session-factory> 

<!--SQL dialect--> 

<property name="dialect">org.hibernate.dialect.HSQLDialect 
</property>@ 

<! --Database connection settings-->@ 

<property name="connection.driver class">org.hsqldb.jdbcDriver 
</property> 

<property name="connection.url">jdbec: hsgqldb: data/music 
</property> 

<property name="connection.username" >sa</property> 

<property name="connection.password" ></property> 

<property name="connection. shutdown" >true</property> 

<! --JDBC connection pool (use the built-in one) --> 

<property name="connection.pool size" >] </property>®@ 

<! --Enable Hibernate's automatic session context management--> 

<property name="current session context class">thread</property 









































<! --Disable the second-level cache-->@ 

<property 

name="cache.provider class">org.hibernate.cache.NoCacheProvider 
</property> 

<! --disable batching so HSQLDB will propagate errors correctly.- 
-> 

<property name="jdbc.batch_size">0</property>@ 

<! --Echo all executed SQL to stdout--> 

<property name="show_sql">true</property>@ 

<! --List all the mapping documents we're using-->@ 

<mapping resource="com/oreilly/hh/data/Track.hbm.xml"/> 

</session-factory> 

</hibernate-configuration> 









































从 示例 中 可 以 看 到 ，hibernate.cfg.xml 配 置 了 SQL 方言 、JDBC 参 
数 、 连 接 池 (connection pool) 以 及 缓存 提供 者 (cache provider) 。 这 
个 XML 文档 还 引用 了 我 们 在 上 一 章 写 的 映射 文档 ， 这 样 就 不 需要 我 们 
再 从 Java 源 代码 中 引用 这 些 映 射 文档 了 。 稍 后 将 详细 介绍 这 一 配置 文件 
的 细节 : 


@ 就 像 第 2 章 的 hibernate.properties 文 件 一 样 ， 我 们 在 这 一 行 是 为 使 





用 HSQLDB 而 定义 它 的 SQL 方言 。 你 可 能 已 经 注意 到 property 元 素 的 
name 属 性 是 dialect， 类 似 于 .properties 文 件 中 的 属性 的 名 称 〈 也 就 是 
hibernate.dialect) 。 当 使 用 XML 配置 文件 来 配置 Hibernate 时 ， 其 实 也 是 
在 向 Hibernate 传 递 了 同样 的 属性 。 在 XML 配置 文件 中 ， 可 以 省 略 属 性 名 
称 的 hibernate. 前 级 。 这 一 区 段 (dialect) 和 下 一 区 段 (connection) 的 配 
置 方法 与 我 们 在 第 2 章 hibernate.properties 文 件 中 的 配置 是 一 样 的 。 


信用 于 配置 Hibernate 内 部 的 JDBC 连 接 的 属性 
(connection.driver_class、connection.url、connection.username、 
connection.password 以 及 connection.shutdown ) 与 例 2-4 的 
hibernate.properties 中 的 属性 集 也 一 一 对 应 。 


全 将 connection.pool_size 属 性 设置 为 1。 这 意味 着 Hibernate 将 创建 一 
个 只 保持 一 个 连接 的 JDBC Connection (连接 ) 池 。 数 据 库 连 接 池 对 于 
需要 达到 一 定 规模 的 大 型 应 用 程序 来 说 很 重要 ， 不 过 就 本 书 的 目的 来 
说 ， 我 们 可 以 放心 地 将 Hibernate 配 置 为 使 用 只 有 一 个 JDBC 连 接 的 内 建 
连接 池 。 在 连接 池 实 现 上 ，Hibernate 支 持 很 大 的 灵活 性 ， 可 以 非常 容易 
地 配置 Hibernate 来 使 用 其 他 的 连接 池 实 现 ， 例 如 Apache Commons 
DBCP 和 C3P0。 


四 照 目前 情况 ， 当 Hibernate 执 行 实际 的 持久 化 操作 时 ， 它 就 会 警告 
我 们 还 没有 配置 它 的 二 级 缓存 系统 。 对 于 像 这 样 的 简单 应 用 程序 来 说 ， 
我 们 根本 不 需要 二 级 缓存 ， 所 以 这 一 行 配置 就 是 要 关闭 二 级 缓存 ， 将 每 


个 操作 立即 发 送 到 数据 库 。 


加 这 里 ， 我 们 是 在 关闭 Hibernate 的 JDBC 批 处 理 功 能 。 虽 然 这 样 做 
会 稍微 降低 一 点 效率 〈 对 于 像 HSQLDB 这 样 的 内 存 数据 库 的 影响 微 乎 其 
微 ) ， 不 过 为 了 获取 当前 HSQLDB 和 触发 的 错误 报告 ， 有 必要 这 样 做 。 当 
打开 批 处 理 模式 时 ， 如 果 批 处 理 中 有 任何 语句 出 了 问题 ， 从 HSQLDB 中 
得 到 的 惟一 异 闸 将 只 是 BatchUpdateException， 告 诉 你 批 处 理 失 败 。 这 
样 错误 报告 对 调试 程序 几乎 没有 什么 用 。HSQLDB 的 作者 说 这 个 问题 将 
在 下 一 个 主要 发 行 版 本 中 得 以 修复 ; 在 此 之 前 ， 当 使 用 HSQLDB 时 ， 为 
了 明白 问题 的 来 龙 去 脉 ， 我 们 就 先 不 使 用 批 处 理 模式 。 





@how_sql 属 性 是 一 个 在 开发 和 调试 Hibernate 程 序 时 使 用 的 属性 。 
将 show_sql 设 置 为 tue， 就 告诉 Hibernate 要 它 打印 输出 对 数据 库 操 作 时 
执行 的 每 条 语句 。 如 果 你 不 希望 在 控制 台 看 到 打印 输出 的 SQL 语句 ， 可 
以 将 这 个 属性 设置 为 false。 


人 @ 最 后 一 部 分 列 出 了 在 我 们 的 项 目 中 使 用 的 所 有 了 映射 文档 。 注 意 ， 
路 径 中 包含 的 斜 杠 字符 〈“/) 是 相对 于 src 目 录 的 。 这 一 路 径 指明 
了 .hbm.xml 文 件 作为 资源 在 类 路 径 上 的 位 置 。 通 过 在 这 里 列 出 这 些 文 
件 ， 我 们 就 不 用 在 处 理 映 射 类 的 build.xml 构 建 目 标 中 显 式 说 明 如 何 找到 
它们 《 稍 后 可 以 看 到 ) ， 也 不 需要 像 本 书 的 旧版 那样 在 每 个 例子 源 代码 
main O 方法 中 加 载 这 些 映 射 文档 。 把 所 有 映 财 文档 集中 在 一 起 是 个 
不 错 的 做 法 。 





除了 src 目 录 下 的 hibernate.cfg.xml 文 件 ， 还 需要 修改 build.xml 以 引用 
这 个 新 的 XML 配置 文件 。 修 改 codegen 和 schema 构 建 目 标 内 的 
configuration 元 素 ， 如 例 3-2 中 用 粗 体 显 示 的 几 行 所 示 。 例 3-2: 修改 
build.xml， 以 使 用 新 的 Hibernate XML 配置 文件 








<! --Generate the java code for all mapping files in our source 
tree--> 

<target name="codegen"depends="prepare" 

description="Generate Java source from the O/R mapping files"> 

<hibernatetool destdir="${source.root}"> 

<configuration 
























































configurationfile="S{source.root}/hibernate.cfg.xml"/> 
<hbm2java/> 
</hibernatetool> 
</target> 
<! --Generate the schemas for all mapping files in our class 
tree--> 


<target name="schema"depends="prepare" 

description="Generate DB schema from the O/R mapping files"> 

<hibernatetool destdir="${source.root}"> 

<configuration 
configurationfile="S{source.root}/hibernate.cfg.xml"/> 

<hbm2ddl1 drop="yes"/> 

</hibernatetool> 

</target> 






































这 两 行 告诉 Hibernate Tools Ant 构 建 任 务 ， 到 哪里 查找 Hibernate 
XML 配置 文件 ， 这 样 ，Ant 任 务 就 可 以 在 这 个 配置 文件 中 找到 它们 需要 
的 所 有 信息 《包括 正在 处 理 的 映射 文档 ;回想 一 下 第 2 章 的 做 法 ， 我 们 
不 得 不 在 configuration 元 兹 中 显 式 构建 了 Ant 的 fleset 元 素 ， 以 匹配 项 目 
源 代码 树 中 的 所 有 映射 文件 ) 。 从 现在 起 ， 本 书 的 剩余 部 分 将 全 部 使 用 


Hibernate XML 配置 文件 ， 这 样 可 以 更 方便 地 为 Hibernate 的 相关 工具 传 
递 各 种 需要 的 信息 。 


现在 我 们 已 经 成 功 地 配置 好 了 Hibernate， 下 面 我 们 就 回 到 本 章 的 主 
要 任务 : 生成 持久 化 对 象 。 


创建 持久 化 对 象 


我 们 先 创 建 几 个 新 的 Track 实例 ， 再 把 它们 持久 化 保存 到 数据 库 ， 
这 样 就 能 看 看 对 象 到 底 是 怎样 转换 成 数据 库 表 的 行 和 列 的 。 因 为 我 们 完 
全 按照 标准 的 Hibernate 要 求 来 组 织 映射 文档 和 配置 文件 ， 所 以 配置 
Hibernate 的 会 话 工 厂 (session factory) 也 就 变 得 相当 容易 了 。 


应 该 怎么 做 


这 里 的 讨论 假设 你 已 经 按照 第 2 章 的 示例 ， 创 建 好 了 数据 库 模 式 ， 
并 生成 了 Java 代 码 。 如 果 你 还 没有 做 这 些 ， 可 以 从 本 书 的 网 站 ( 叫 ) 下 
载 示例 文件 ， 直 接 跳 转 到 ch03 目 录 ， 使 用 命令 ant prepare 和 ant 
codegen (7!) ， 再 接着 执行 ant schema， 就 可 以 自动 取 回 这 个 示例 所 需 
要 的 Hibernate 和 HSQLDB 库 ， 并 生成 Java 代 码 和 数据 库 模 式 。 (和 其 他 
示例 一 样 ， 这 些 命令 都 应 该 在 shell 窗 口中 执行 ， 而 当前 工作 目录 就 是 你 
的 项 目 目录 树 的 顶级 目录 ， 也 就 是 包含 Ant build.xml 文 件 的 地 方 。) 





我 们 先 从 一 个 简单 的 示范 用 的 CreateTest 类 开始 ， 它 包含 了 必要 的 
SA Cimport) 语句 ， 以 及 一 些 辅助 代码 ， 用 于 设 定 Hibernate 环 境 ， 再 
创建 几 个 用 XML 映射 文件 来 进行 持久 化 存储 的 Track 实例 。 源 代码 如 例 
3-3 所 示 ， 它 位 于 src/com/oreilly/hh 目 录 中 。 


例 3-3: 数据 创建 测试 ，CreateTest.java 


package com.oreilly.hh; 

import org.hibernate.*; @ 
import org.hibernate.cfg.Configuration; 
import com.oreilly.hh.data.*; 























import java.sql.Time; 
import java.util.Date; 
/** 

















*Create sample data, letting Hibernate persist it for us. 


ay 
public class CreateTest{ 

public static void main (String args[]) thr 
//Create a configuration based on the XML 
//in the standard place. 
Configuration config=new Configuration () ; 
config.configure () ; 
































ows Exception{ 





file we've put 


(2) 


//Get the session factory we can use for persistence 
SessionFactory sessionFactory=config.buildSessionFactory O ; ® 




















//Ask for a session using the JDBC information we've conf 








Session session=sessionFactory.openSession 
Transaction tx=null; 

try{ 

//Create some data and persist it 
tx=session.beginTransaction (); © 

Track track=new Track ("Russian Trance", 
"vyol2/album610/track02.mp3", 

Time.valueOf ("00: 03: 30") , new Date () , 
(short) 0). 

session.save (track) ; 




















);@ 


track=new Track ("Video Killed the Radio Star", 


"vyol2/album611/track12.mp3"; 
Time.valueOf ("00: 03: 49") , new Date () ， 
(short) 0) ; 

session.save (track) ; 

track=new Track ("Gravity's Angel", 
"vyol2/album175/track03.mp3", 
Time.valueOf ("00: 06: 06") , new Date () ， 
(short) 0) ; 

session.save (track) ; 

//We're done; make our changes permanent 
tx.commit (); @ 

}catch (Exception e) { 

if (tx! =null) { 

//Something went wrong; discard all partial 



































changes 








figured 


tx.rollback ©) ; 
} 
throw new Exception ("Transaction failed", e); 
}finally{ 
//No matter what, close the session 
session.close () ; 

} 

//Clean up after ourselves 
sessionFactory.close (); @ 

} 

} 


























需要 对 CreateTest.java 的 第 一 部 分 做 些 解 释 : 


各 我 们 导入 一 些 有 用 的 Hibernate 类 〈 包 括 Configuration) ， 用 它们 
来 建立 Hibernate 运 行 环境 。 此 外 还 需要 导入 Hibernate 根 据 映射 文档 生成 
的 所 有 数据 类 ， 这 些 都 在 data 包 中 。 数 据 对 象 中 用 Time 和 Date 类 来 代表 
曲目 的 播放 时 间 和 创建 时 间 戳 〈timestamp) 。 在 CreateTest 中 实现 的 惟 
一 方法 是 main O 方法 ， 以 支持 从 命令 行 的 调用 。 


四 当 运 行 这 个 类 时 ， 它 首先 创建 一 个 Hibernate Configuration 对 象 。 
由 于 我 们 没有 告诉 Hibernate 什 么 其 他 信息 ， 所 以 它 默 认 在 类 路 径 的 根 上 
查找 名 为 hibernate.cfg.xml 的 文件 。Hibernate 会 找到 我 们 前 面 创 建 的 这 个 
配置 文件 ， 通 过 这 个 配置 文件 来 告诉 Hibernate 我 们 正在 使 用 HSQLDB， 
以 及 如 何 找到 数据 库 。 这 个 例子 的 XML 配置 文件 就 包含 了 对 Track 对 象 
的 Hibernate Mapping XML 文档 的 引用 。 调 用 config.configure O WE A 
动 加 载 Track 类 的 映射 文档 。 


全 为 了 创建 和 持久 化 曲目 数据 ， 这 就 是 我 们 需要 的 所 有 配置 ， 这 样 


就 为 创建 SessionFactory 做 好 了 准备 。 该 对 象 的 用 途 是 为 我 们 提供 会 话 对 
象 ， 它 是 同 Hibernate 进 行 交 互 的 主要 途径 。SessionFactory 是 线程 安全 

的 ， 在 整个 应 用 程序 中 只 需要 创建 它 的 一 个 实例 (更 准确 地 说 ， 对 于 每 
-个 需要 提供 持久 化 服务 的 数据 库 环 境 ， 只 需要 一 个 SessionFactory 实 

fil; 因此 大 多 数 应 用 程序 只 需要 一 个 这 样 的 实例 ) 。 创 建 会 话 工厂 是 一 
个 需要 花费 相当 代价 和 耗 时 的 操作 ， 所 以 应 该 在 整个 应 用 程序 中 共享 这 
个 实例 。 在 只 包含 一 个 类 的 应 用 程序 中 进行 这 样 的 操作 显得 有 些 繁 琐 ， 
不 过 ， 参 考 文档 提供 了 一 些 在 更 实现 的 场景 中 应 该 如 何 应 用 的 好 例子 。 




















注意 : 牢固 地 理解 这 些 对 象 的 目的 和 生命 周期 ， 值 ! 本 书 介绍 的 知 
识 足 以 让 你 起 步 了 ;你 应 该 继续 花 些 时 间 了 阅读 参考 文档 ， 深 入 理解 各 个 
例子 。 





四 这 一 步 才 到 了 真正 执行 持久 化 的 时 候 ， 让 SessionFactory 打 开 一 个 
会 话 ， 这 会 建立 一 个 到 数据 库 的 连接 ， 并 提供 一 个 上 下 文 Context) 环 
境 ， 在 这 个 上 下 文中 我 们 可 以 创建 、 获 取 、 处 理 以 及 删除 持久 化 对 象 。 
只 要 保持 会 话 为 打开 状态 ， 就 会 维护 一 个 到 数据 库 的 连接 ， 与 会 话 相 关 
联 的 持久 对 象 的 变化 都 可 以 被 跟 踊 ， 这 样 ， 当 关闭 会 话 时 ， 这 些 变 化 就 
可 以 应 用 到 数据 库 。 从 概念 上 说 ， 你 可 以 把 会 话 认 为 是 持久 化 对 象 和 数 
据 库 之 间 的 一 个 “大 型 事务 ”， 它 可 以 包含 多 个 数据 库 级 的 事务 。 不 过 ， 
和 数据 库 事务 一 样 ， 在 应 用 程序 运行 期 间 长 时 间 地 打开 Hibernate 
session〈 例 如 在 等 候 用 户 输入 时 ) 。 在 应 用 程序 中 一 个 会 话 只 用 于 一 个 





特定 的 、 边 界 有 限 的 操作 ， 例 如 生成 用 户 界 面 或 者 根据 用 户 提交 的 信息 
做 出 相应 的 变化 。 而 随后 的 操作 则 使 用 一 个 新 的 会 话 。 还 要 注意 的 是 ， 
会 话 对 象 本 里 不 是 线程 安全 的 ， 所 以 不 能 在 线程 之 间 共 至 它们 。 每 个 线 
程 需 要 从 会 话 工 厂 类 中 获取 它们 自己 的 会 话 。 











有 必要 深入 介绍 一 下 Hibernate 中 映射 对 象 的 生命 周期 ， 以 及 它 与 会 
话 的 关系 ， 因 为 这 一 术语 相当 特殊 ， 相 关 的 概念 也 很 重要 。 一 个 映射 对 
象 “例如 我 们 的 Track 类 的 一 个 实例 ) 会 在 与 Hibernate 相 关 的 两 个 状态 
之 间 回 来 转换 : 瞬时 状态 〈transient) 和 持久 化 状态 (persistent) 。 处 
于 瞬时 状态 的 对 象 不 与 任何 会 话 关 联 。 当 用 new〈) 第 一 次 创建 一 个 
Track 实例 时 ， 它 就 是 瞬时 状态 的 ;除非 告诉 Hibernate 持 和 久 化 这 个 瞬时 
状态 的 对 象 ， 否 则 当 应 用 程序 结束 时 ， 这 个 对 象 就 会 永远 消失 。 





将 一 个 瞬时 状态 的 映射 对 象 传递 给 会 话 的 save〈) 方法 ， 就 会 持久 
化 保存 这 个 对 象 ， 这 样 ， 在 Java VM 结 束 以 后 ， 这 个 数据 对 象 还 能 够 存 
在 ， 直 到 以 后 显 式 地 删除 它 。 如 果 你 已 经 有 了 一 个 持久 化 对 象 ， 并 对 它 
调用 会 话 的 delete〈) 方法 ， 这 个 对 象 就 会 再 回 到 瞬时 状态 。 虽 然 这 个 
对 象 在 应 用 程序 中 仍然 作为 一 个 实例 而 存在 ， 但 它 不 会 持久 保存 起 来 ， 
除非 你 改变 了 主意 ， 要 再 保存 它 一 次 。 男 一 方面 ， 如 果 你 还 没有 删除 这 
个 对 象 ( 所 以 它 仍 然 处 于 持久 化 状态 ) ， 当 修改 这 个 对 象 后 ， 为 了 让 对 
象 的 变化 得 以 反映 到 数据 库 中 ， 并 不 需要 再 显 式 地 保存 它 一 次 。 
Hibernate 会 自动 跟踪 对 任何 持久 化 对 象 作出 的 修改 ， 并 在 适当 的 时 机 将 











这 些 变化 刷新 写 入 到 数据 库 中 。 当 关闭 会 话 时 ， 任 何 延迟 的 变化 都 会 被 
保存 到 数据 库 中 。 


注意 : 坚持 一 下 ， 我 们 很 快 束 回 到 例子 的 介绍 ! 


当 在 已 经 关闭 的 会 话 中 使 用 持久 化 对 象 ， 例 如 ， 当 运行 完 一 个 查 
询 ， 找 到 所 有 [匹配 某 条 件 的 实体 (本 章 稍 后 的 “检索 持久 化 对 象 ” 一 节 将 
介绍 如 何 做 到 这 一 点 ) 以 后 ， 处 理 这 些 实体 的 状态 就 涉及 一 个 重要 但 又 
微妙 的 要 点 。 如 前 所 述 ， 保 持 会 话 打开 的 时 间 最 好 不 要 超过 执行 数据 库 
操作 的 必要 时 间 ， 所 以 在 查询 完成 以 后 ， 就 应 该 马上 关闭 会 话 。 如 果 这 
时 再 处 理 已 经 加 载 的 映射 对 象 ， 会 怎么 样 ? 喝 ， 当 会 话 打 开 时 ， 这 些 对 
象 确 实 是 持久 化 对 象 ， 但 是 它们 现在 不 再 与 任何 活动 的 会 话 相 关联 了 
(在 这 个 例子 中 ， 是 因为 关闭 了 会 话 ) ， 所 以 它们 就 不 再 是 持久 化 对 象 
了 。 不 过 ， 这 并 不 意味 着 它们 代表 的 数据 在 数据 库 中 也 不 存在 了 ; 相 
反 ， 如 果 再 次 运行 查询 《假设 这 时 没有 人 修改 过 数据 ) ， 还 是 能 够 取 回 
同样 的 一 组 对 象 。 这 只 是 意味 着 : 数据 对 象 的 状态 在 虚拟 机 和 数据 库 之 
间 当 前 没有 通信 ， 它 们 处 于 脱 管状 态 Cdetached) 。 完 全 有 理由 可 以 继 
续 使 用 这 种 对 象 。 如 果 以 后 需要 修改 这 些 对 象 ， 还 想 把 这 些 修改 持久 保 
存 ， 你 可 以 打开 一 个 新 的 会 话 ， 用 它 来 保存 修改 过 的 对 象 。 因 为 每 个 实 
体 都 有 一 个 惟一 的 ID， 在 新 的 会 话 中 ，Hibernate 没 有 问题 地 可 以 知道 如 
何 把 处 于 瞬时 状态 的 对 象 链接 到 正确 的 持久 化 对 象 。 

















当然 ， 对 脐 管 对 象 信息 的 修改 都 要 由 具体 的 数据 库 环 境 作为 文 持 ， 





FIT OMAR is BAAS BS DM HAEST R I 7G EEA AY HE m ETT RA eX 
HERRENE EP OT SR BE. ER Hibernate Aik — fEF 
也 提供 了 一 定 帮 助 ， 但 是 设计 和 实现 细节 还 得 由 你 负责 。 参 考 手册 强烈 
推荐 使 用 一 个 version 字 段 ， 而 且 也 有 多 种 办 法 可 供 选 用 。 








加 有 了 这 些 概念 和 术语 ， 这 个 例子 的 其 他 部 分 束 很 容易 理解 了 。 我 
们 用 打开 的 会 话 建 立 了 一 个 数据 库 事务 ， 在 这 个 事务 内 部 ， 又 创建 了 一 
些 包含 示例 数据 的 Track 实例 ， 并 在 会 话 中 进行 保存 ， 这 样 就 把 它们 由 
瞬时 状态 的 实例 转变 为 持久 化 的 实体 。 





@ 最 后 ， 我 们 提交 事务 ， 自 动 地 (作为 一 个 单独 的 、 不 可 分 割 的 单 
元 ) 将 所 有 数据 库 修改 持久 化 。 环 绕 着 所 有 这 些 代 码 周围 的 
try/catch/finally 块 演示 了 在 进行 事务 处 理 时 一 种 重要 而 且 有 用 的 习惯 用 
法 。 如 果 操 作 期 间 发 生 了 任何 错误 ，catch 块 就 会 回 深 Croll back) 事 
务 ， 再 抛 出 异常 。 在 finally 部 分 中 会 关闭 会 话 ， 以 确保 无 论 我 们 是 成 功 
提交 事务 后 沿 着 “愉快 的 小 路 ”正常 退出 ， 还 是 因为 导致 回 滚 的 异常 而 退 
出 ， 最 终 都 可 以 关闭 会 话 。 











@ 在 方法 最 后 ， 我 们 也 关闭 了 会 话 工厂 本 身 。 这 是 应 用 程序 中 “ 优 
雅 地 关闭 ”(graceful shutdown) 部 分 应 该 进行 的 操作 。 在 Web 应 用 环境 
中 ， 这 应 该 是 一 定 的 生命 周期 事件 处 理 器 。 在 这 个 简单 的 例子 中 ， 妆 
main O 方法 返回 时 ， 应 用 程序 就 正在 结 











现在 一 切 就 结 ， 通 知 Ant 如 何 编译 和 运行 这 个 测试 程序 就 更 简单 
了 。 将 例 3-4 所 示 的 构建 目标 添加 a 到 build.xml 末 尾 的 二 /project 二 关闭 标 
签 之 前 。 


例 3-4: 用 于 编译 所 有 Java 源 代码 ， 并 调用 数据 创建 测试 的 Ant 构 建 
目标 








<! --Compile the java source of the project--> 

<target name="compile"depends="prepare"@ 

description="Compiles all Java classes"> 

<javac srcdir="S{source.root}" 

destdir="${class.root}" 

debug="on" 

optimize="off" 

deprecation="on"> 

<classpath refid="project.class.path"/> 

</javac> 

</target> 

<target name="ctest"description="Creates and persists some sample 
data" 

depends="compile">@ 

<java classname="com.oreilly.hh.CreateTest"fork="true"> 

<classpath refid="project.class.path"/> 

</java> 

</target> 









































人 @ 命 名 得 体 的 编译 构建 目标 使 用 内 建 的 javac 构 建 任务 ， 将 src 目 录 
中 的 所 有 Java 源 文件 编译 到 classes 目 录 中 。 幸 好 ， 这 个 构建 任务 也 支持 
我 们 已 经 建立 的 项 目 类 路 径 ， 所 以 编译 器 能 够 找到 我 们 正在 使 用 的 所 有 
依赖 库 。 构 建 目 标定 义 中 的 depends=prepare 属 性 是 告诉 Ant 在 运行 编译 
构建 目标 以 前 ， 必 须 先 运行 prepare。Ant 负 责 管理 依赖 关系 ， 当 构建 具 
有 依赖 关系 的 多 个 目标 时 ， 能 够 以 正确 的 顺序 执行 ， 每 个 依赖 只 执行 一 





次 ， 即 便 多 个 构建 目标 都 引用 了 同一 个 依赖 。 


如 果 你 习惯 使 用 shell 脚 本 来 编译 很 多 Java 源 代码 ， 那 么 可 能 会 对 这 
么 快 的 编译 速度 感到 吃惊 。Ant 调 用 的 是 它 自己 使 用 的 虚拟 机 内 部 的 
Java 编 译 器 ， 所 以 没有 和 针对 每 个 编译 的 处 理 启 动 延 迟 。 





外 ctest 构 建 目 标 使 用 编译 来 确保 已 经 构建 好 了 所 有 类 文件 ， 接 着 再 
创建 一 个 新 的 Java 虚 拟 机 来 运行 我 们 的 CreateTest 类 。 


好 了 ， 我 们 可 以 创建 一 些 数据 了 ! 例 3-5 显 示 了 调用 新 的 ctest 构 建 目 
标的 结果 。ctest 要 依赖 于 compile 构 建 目 标 ， 这 样 融 能 确保 在 使 用 之 前 
CreateTest 类 会 完 编译 好 。ctest 本 号 的 输出 结果 会 显示 Hibernate 所 及 出 的 
日 志 信 息 《〈 建 立 环境 和 映射 数据 以 及 数据 库 连 接 的 关闭 ) 。 


例 3-5: 调用 CreateTest 类 





sant ctest 

prepare: 

compile: 

[javac]Compiling 2 source files 
to/Users/jim/svn/oreilly/hib_ dev 2e/ 

current/examples/ch03/classes 




















etest: 
[java] 00: 21: 45, 833 INFO Environment: 514-Hibernate 3.2.5 
[java]00: 21: 45, 852 INFO Environment: 547-hibernate.properties 








not found 
[java] 00: 21: 45, 864 INFO Environment: 681-Bytecode provider 
name: cglib 
[java]00: 21: 45, 875 INFO Environment: 598-using JDK 1.4 
java.sql.Timestam 
handling 

[java]00: 21: 46, 032 INFO Configuration: 1426-configuring from 
resource: / 















































ae) 























hibernate.cti 


fg .xml 








[java]00: 21: 46, 034 INFO Configuration: 1403-Configuration 
resource: /hib 
ernate.cfg.xml 





[java]00: 21: 
resourc 


46, 

















302 INFO Configuration: 553-Reading mappings from 


e: com/oreilly/hh/data/Track.hbm. xml 





[java]00: 21: 
com.oreilly.hh.dat 
a.Track->TRACK 


[java]00: 21 


46, 





: 46, 


SessionFactory: n 


ull 
[java]00: 21: 46, 860 INFO DriverManagerConnectionProvider: 41- 


Using Hibern 





Hibernate co 








using driver 





[java]00: 21 


connection p 





Database E 
ngine Driver, ver 


org 


de 














roperties: 

[java]00: 21: 
Engine, 

version: 1.8 

[java]00: 21: 





46, 





46, 


: 46, 


47, 


.0 
47， 





605 INFO HbmBinder: 300-Mapping class: 














678 INFO Configuration: 1541-Configured 

















ate built-in connection pool (not for production use! ) 
[java]00: 21: 46, 862 INFO DriverManagerConnectionProvider: 42- 





nnection pool size: 1 
[java]00: 21: 
autocommit m 
ode: false 
[java]00: 21: 





864 INFO DriverManagerConnectionProvider: 45- 








879 INFO DriverManagerConnectionProvider: 80- 


org.hsqldb.jdbcDriver at URL: jdbc: hsqldb: data/music 





891 INFO DriverManagerConnectionProvider: 86- 


{user=sa, password=****, shutdown=true} 








533 INFO SettingsFactory: 89-RDBMS: HSQL Database 























538 INFO SettingsFactory: 90-JDBC driver: HSQL 





sion: 1.8.0 





[java]00: 21 


-hibernate.d 
t.HSQLDialect 
[java]00: 21: 
fault tran 

saction str 
[java]00: 21: 











Transacti 


or transaction 


: 47, 
ialec 


47, 


47, 


613 INFO Dialect: 152-Using dialect: 








638 INFO TransactionFactoryFactory: 31-Using 





ategy (direct JDBC transactions) 





646 INFO TransactionManagerLookupFactory: 33-No 





onManagerLookup configured (in JTA environment, use of read-write 





al second-level cache is not recommended) 








[java]00: 21: 47, 649 INFO SettingsFactory: 143-Automatic flush 
during befo 





reCompletion () : disabled 


[java]00: 21: 47, 650 INFO SettingsFactory: 147-Automatic session 
close at 
end of transaction: disabled 









































[java]00: 21: 47, 657 INFO SettingsFactory: 154-JDBC batch size: 15 
[java]00: 21: 47, 659 INFO SettingsFactory: 157-JDBC batch updates 
for vers 





ioned data: disabled 

[java]00: 21: 47, 664 INFO SettingsFactory: 162-Scrollable result 
sets: ena 

bled 

[java]00: 21: 47, 666 INFO SettingsFactory: 170-JDBC3 
getGeneratedKeys (): d 

isabled 

[java]00: 21: 47, 668 INFO SettingsFactory: 178-Connection release 
mode: au 

to 
[java]00: 21: 47, 671 INFO SettingsFactory: 205-Default batch fetch 
size: 1 
[java]00: 21: 47, 678 INFO SettingsFactory: 209-Generate SQL with 
comments: 
disabled 
[java]00: 21: 47, 680 INFO SettingsFactory: 213-Order SQL updates 
by primar 
y key: disabled 
[java]00: 21: 47, 681 INFO SettingsFactory: 217-Order SQL inserts 
for batch 

ing: disabled 

[java]00: 21: 47, 684 INFO SettingsFactory: 386-Query translator: 
org.hiber 

nate.hgl.ast.ASTQueryTranslatorFactory 

[java]00: 21: 47, 690 INFO ASTQueryTranslatorFactory: 24-Using 
ASTQueryTran 

slatorFactory 

[java]00: 21: 47, 694 INFO SettingsFactory: 225-Query language 
substitution 

s: {} 

[java]00: 21: 47, 695 INFO SettingsFactory: 230-JPA-QL strict 
compliance: d 

isabled 

[java]00: 21: 47, 702 INFO SettingsFactory: 235-Second-level 
cache: enabled 

[java]00: 21: 47, 704 INFO SettingsFactory: 239-Query cache: 
disabled 

[java]00: 21: 47, 706 INFO SettingsFactory: 373-Cache provider: 
org.hiberna 

te.cache.NoCacheProvider 

[java]00: 21: 47, 707 INFO SettingsFactory: 254-Optimize cache for 
minimal 


















































































































































puts: disabled 

[java]00: 21: 47, 709 INFO SettingsFactory: 263-Structured second- 
level cac 

he entries: disabled 

[java]00: 21: 47, 724 INFO SettingsFactory: 283-Echoing all SQL to 
stdout 

[java]00: 21: 47, 731 INFO SettingsFactory: 290-Statistics: 
disabled 

[java]00: 21: 47, 732 INFO SettingsFactory: 294-Deleted entity 
synthetic id 

entifier rollback: disabled 
[java]00: 21: 47, 734 INFO SettingsFactory: 309-Default entity- 
mode: pojo 
[java]00: 21: 47, 735 INFO SettingsFactory: 313-Named query 
checking: enab 
led 
[java]00: 21: 47, 838 INFO SessionFactorylImpl: 161-building session 
factory 
[java]00: 21: 48, 464 INFO SessionFactoryObjectFactory: 82-Not 
binding fact 
ory to JNDI, no JNDI name configured 
[java]Hibernate: insert into TRACK (TRACK ID, title, filePath, 
playTime, a 
dded, volume) values (null, ?, ?, ?, ?, 2?) 
[java]Hibernate: call identity © 
[java]Hibernate: insert into TRACK (TRACK ID, title, filePath, 
playTime, a 

dded, volume) values (null, ?, ?, ?, ?, ?) 

[java]Hibernate: call identity © 

[java]Hibernate: insert into TRACK (TRACK ID, title, filePath, 
playTime, a 

dded, volume) values (null, ?, ?, ?, ?, 2?) 

[java]Hibernate: call identity © 

[java]00: 21: 49, 365 INFO SessionFactoryImpl: 769-closing 

[java]00: 21: 49, 369 INFO DriverManagerConnectionProvider: 147- 
cleaning up 

connection pool: jdbc: hsgqldb: data/music 
BUILD SUCCESSFUL 
Total time: 2 seconds 


































































































































































































REITAFR 


如 果 你 查看 Hibernate 打 印 输出 的 所 有 消 妃 《因为 我 们 打开 了 日 志 


的 "info" 级 别 的 输出 标志 ) ， 你 可 以 看 到 我 们 的 测试 类 会 局 动 
Hibernate， 加 载 Track 类 的 映射 信息 ， 打 开 一 个 持久 会 话 (persistence 
session) 以 连接 相关 的 HSQLDB 数 据 库 ， 再 创建 一 些 实 例 ， 并 用 会 话 将 
它们 持久 化 保存 到 TRACK 数据 库 表 中 。 接 着 ， 再 关闭 这 个 会 话 和 数据 
库 连接 ， 以 确保 数据 正确 地 完成 存储 。 





行 完 这 个 测试 以 后 ， 你 可 以 用 ant db 看 一 看 数据 库 的 内 容 。 现 
在 ， 你 应 该 可 以 在 TRACK 表 中 看 到 三 条 记录 ， 如 图 3-1 所 示 〔 在 窗口 顶 
部 的 文本 框 中 输入 查询 语句 ， 点 击 "Execute" 按 钮 。 也 可 以 选择 菜单 栏 中 
的 "Command" "Select"， 会 得 到 一 个 SQL 命 令 的 框架 和 语法 说 明文 
4) 





eoe l _ HSQL Database Manager 


E jdbc hsqldb. datasmusic 
B TRACK 
thema: PUBLIC 
B TRACKID 
































Œ TITLE 

困 FILEPATH 

i a Russian Trance wal? falbum6 LOftrackO? mp3 00:03:30 7007-06 

E VOLUME 2 Video Killed the Radivel? falbumé Li ftrackl?2 mpd 0003:49 2007-06 
3 Gravity's Angel wlz falbum 17S frackOs mos 000606 2007-06 





& Indices 
A Properties 





图 3-1 持久 保存 到 TRACK 表 中 的 测试 数据 


现在 ， 我 们 停 下 来 一 会 儿 ， 反 思 一 个 事实 一 我 们 没有 编写 任何 连接 


数据 库 或 执行 SQL 命令 的 代码 。 再 回想 上 一 节 ， 我 们 甚至 也 不 必 杀 目 创 
建 数据 库 表 和 封装 数据 的 Track 对 象 。 但 是 ， 图 3-1 中 碍 询 和 输出 显示 的 那 
些 整整 齐 齐 的 数据 表明 ， 我 们 简短 的 测试 程序 确实 已 经 创建 了 Java 对 
象 ， 并 正确 地 进行 了 持久 化 处 理 。 希 望 你 可 以 因此 而 认同 ， 作 为 一 种 持 
久 化 服务 ，Hibernate 真 的 功能 强大 、 使 用 方便 。 作 为 一 种 免费 的 、 轻 型 
的 工具 ，Hibernate 确 实 为 我 们 完成 了 很 多 工作 ， 这 一 切 又 是 那么 的 快捷 
而 简单 ! 





如 果 你 以 前 直接 用 过 JDBC， 尤 其 是 当 你 还 不 太 熟 悉 它 时 ， 你 可 能 
习惯 使 用 数据 库 驱 动 程序 的 "auto-commit" (自动 提交 ) 模式 ， 而 不 是 使 
用 数据 库 事 务 处 理 (transaction) 。Hibemate 同 样 认为 这 是 构造 应 用 程 
序 的 一 种 错误 方法 , “自动 提交 ”模式 惟一 有 意义 的 使 用 场合 就 是 供 人 使 
用 的 数据 库 控制 台 环 境 。 所 以 ， 在 Hibernate 应 用 中 ， 持 久 化 操作 总 是 需 
要 使 用 事务 处 理 。 





如 第 1 章 所 述 ， 你 可 以 在 data 目 录 下 的 music.script 文 件 中 直接 得 看 用 
于 创建 数据 的 SQL 语句 ， 如 例 3-6 所 示 。 





例 3-6: 碍 看 原始 的 数据 库 脚本 文件 


scat data/music.script 
CREATE SCHEMA PUBLIC AUTHORIZATION DBA 






























































CREATE MEMORY TABLE TRACK (TRACK_ID INTEGER GENERATED BY DEFAULT 
AS IDENTITY (STAR 
T WITH 1) NOT NULL PRIMARY KEY, TITLE VARCHAR (255) NOT NULL, 
FILEPATH VARCHAR (255) 
NOT NULL, PLAYTIME TIME, ADDED DATE, VOLUME SMALLINT NOT NULL) 
































































































































ALTER TABLE TRACK ALTER COLUMN TRACK ID RESTART WITH 4 
CREATE USER SA PASSWORD"™" 
GRANT DBA TO SA 
SET WRITE DELAY 10 
SET SCHEMA PUBLIC 
NSERT INTO TRACK VALUES (1, 'Russian 
Trance', 'vol2/album610/track02.mp3', '00: 03: 3 
0', '2007-06-17', 0) 
NSERT INTO TRACK VALUES (2, 'Video Killed the Radio 
Star', 'vol2/album611/track12. 

mp3', '00: 03: 49', '2007-06-17', 0) 
NSERT INTO TRACK VALUES (3, "Gravity''s 
Angel', 'vol2/album175/track03.mp3', '00: 06 

: 06', '2007-06-17', 0) 



































































































































最 后 三 条 语句 是 我 们 的 TRACK 表 的 数据 行 。 脚 本 的 最 前 面包 含 了 
当 创 建新 的 数据 库 时 ， 默 认 使 用 的 模式 和 用 户 名 。《 当 然 ， 在 实际 应 用 
环境 中 ， 你 可 能 需要 修改 这 些 丑 份 验证 信息 ， 除 非 数据 库 只 供 内 存 访问 


(in-memory access) 。) 


JER: 想 多 学 点 HSQLDB? 我 们 支持 你 ! 


其 他 


对 象 和 其 他 对 象 之 间 的 关系 呢 ? 对 象 集合 〈collection ) W? 没 错 ， 
有 些 情况 会 让 持久 化 处 理 更 有 具 挑战 性 (如 果 做 得 好 的 话 ， 就 相当 有 价 
值 )。Hibernate 能 妥善 处 理 这 种 关联 性 。 事 实 上 ， 我 们 不 需要 为 此 花费 
什么 力气 。 在 第 4 章 将 会 讨论 这 一 点 。 就 目前 而 言 ， 让 我 们 先 看 看 如 何 
将 先前 会 话 中 持久 保存 的 对 象 取出 来 。 





[1] http://www.oreilly.com/catalog/9780596517724/, 

(2) 虽然 codegen 构 建 目 标 要 依赖 prepate 构 建 目 标 ， 但 第 一 次 处 理 示例 目 
录 时 ， 你 需要 先 显 式 地 运行 ptepate 以 创建 正确 的 类 路 径 结构 ， 这 样 Ant 
以 后 才 可 以 正常 工作 ， 如 第 2 章 的 2.3 节 所 述 。 


检索 持久 化 对 象 


现在 ， 是 该 来 个 180 度 大 转弯 ， 看 看 如 何 从 数据 库 加 载 数据 到 Java 
对 象 中 。 


使 用 Hibernate 碍 询 语言 (Hibernate Query Language, HQL) ， 吏 能 
以 面 癌 对 象 的 方法 来 检索 映射 到 数据 库 表 的 内 容 。 这 些 数据 可 以 是 以 前 
的 会 话 中 保存 的 持久 化 对 象 ， 也 可 以 是 完全 来 自 于 应 用 程序 代码 以 外 的 
数据 。 





应 该 怎么 做 


例 3-7 演 示 了 一 个 程序 ， 对 我 们 刚才 创建 的 测试 数据 进行 简单 的 奉 
询 。 整 体 的 结构 看 起 来 应 该 非常 熟悉 ， 因 为 所 有 的 Hibernate 设 置 都 和 上 
一 个 程序 相同 。 


例 3-7: 数据 检索 测试 QueryTest.java 


package com.oreilly.hh; 
import org.hibernate.*; 

















import org.hibernate.cfg.Configuration; 
import com.oreilly.hh.data.*; 

import java.sgl.Time; 

import java.util.*; 

/** 

*Retrieve data as objects 


K 





















































public class QueryTest{ 

/** 

*Retrieve any tracks that fit in the specified amount of time. 

* 

*@param length the maximum playing time for tracks to be returned. 
*@param session the Hibernate session that can retrieve data. 
*@return a list of{@link Track}s meeting the length restriction. 

大 


™~S 





public static List tracksNoLongerThan (Time length, Session 
session) {@ 
Query query=session.createQuery ("from Track as track"+ 

"where track.playTime<=?") ; 

gquery.setParameter (0, length, Hibernate.TIME) ; 

return query.list ©) ; 

} 

/** 

*Look up and print some tracks when invoked from the command line. 
x 

public static void main (String args[]) throws Exception{ 

//Create a configuration based on the properties file we've put 
//in the standard place. 
Configuration config=new Configuration () ; 

config.configure () ; 

//Get the session factory we can use for persistence 
SessionFactory sessionFactory=config.buildSessionFactory () ; 
//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 

try{@ 

//Print the tracks that will fit in five minutes 

List tracks=tracksNoLongerThan (Time.valueOf ("00: 05: 00") ， 
session) ; 

for (ListIterator iter=tracks.listIterator () ; 

iter.hasNext (); ) { 

Track aTrack= (Track) iter.next () ; 

System.out.println ("Track: \""+aTrack.getTitle () + 

"\", "taTrack.getPlayTime () ) ; 

} 




















































































































ae. 





finally{ 

//No matter what, close the session 
session.close () ; 

} 

//Clean up after ourselves 
sessionFactory.close () ; 

} 

} 


ee | 








同样 ， 如 例 3-8 所 示 ， 在 build.xml 的 末尾 (在 project 的 关闭 标签 以 
前 〉 添 加 一 个 构建 目标 ， 以 运行 这 个 测试 。 


例 3-8: 


调用 碍 询 测试 的 Ant 构 建 目标 











<target name="gtest"description="Run a simple Hibernate query" 
depends="compile"> 
<java classname="com.oreilly.hh.QueryTest"fork="true"> 


<classpath ref 








id="project.class.path"/> 





</java> 
</target> 
准备 好 以 后 ， 只 要 输入 ant qtest， 就 可 以 检索 出 数据 并 显示 出 来 ， 


结果 如 例 3-9 所 示 。 为 了 节省 输出 结果 占据 的 空间 ， 我 们 编辑 
log4j.properties 文 件 ， 将 所 有 "info" 级 别 的 信息 输出 都 关 掉 ， 因 为 这 些 信 
明和 前 一 个 例子 没有 差别 。 你 可 以 修改 一 下 这 一 行 : 





log4j 








. lLogger.org.hibernate=info 

















into mMwarn: 








log4j 





.lLogger.org.hibernate=warn 
例 3-9: 运行 查询 测试 

Sant qtest 
Buildfile: build.xml 





prepare: 


[copy]C 


opying 1 


file to/Users/jim/svn/oreilly/hib dev_2e/current 





/examples/ch03/classes 
compile: 
[javac]Compiling 1 source file to/Users/jim/svn/oreilly/hib dev 2e 
/current/examples/ch03/classes 





qtest: 








[java]Hibernate: 


track0 .ti 
tled ; 








tle as ti 
trackO _ 








playTimeO , track0O _ 
dded as added0_, track0 .volume as volumeOQ from TRACK track0_ where 
trackO .pla 


select trackO .TRACK ID as TRACK1 0 ; 





.filePath as filePathO , trackO .playTime as 


a 








yTime<=? 

[java]Track: "Russian Trance", 00: 03: 30 

[java]Track: "Video Killed the Radio Star", 00: 03: 49 
BUILD SUCCESSFUL 

Total time: 2 seconds 














KETAN 


种 我 们 先是 定义 了 一 个 工具 方法 : tracksNoLongerThan O , HE 
执行 真正 的 Hibernate 碍 询 ， 取 回 播放 时 间 小 于 或 等 于 参数 指定 的 值 的 任 
何 曲目 。 注 意 HQL 〈Hibernate 根 据 SQL 独 创 的 查询 语言 ) 文 持 参数 占 位 
符 ， 非 常 像 JDBC 中 的 PreparedStatement。 而 且 ， 与 之 类 似 的 是 ， 使 用 参 
数 占 位 符 更 适合 于 通过 字符 串 处 理 将 所 有 查询 集中 在 一 起 (尤其 是 这 样 
可 以 免 受 SQL 注 入 的 攻击 ) 。 不 过 ， 你 将 看 到 ，Hibernate 提 供 了 在 Java 
中 更 好 的 使 用 查询 的 方法 。 








查询 本 身 看 起 来 有 些 古 怪 。 它 以 from 作 为 开始 ， 而 不 是 你 可 能 期 待 
的 像 select something 之 类 的 语句 。 虽 然 你 确实 可 以 使 用 与 标准 SQL 更 加 
类 似 的 格式 ， 而 且 当 需 要 在 查询 中 从 一 个 对 象 提取 出 单独 的 属性 时 ， 也 
只 能 这 么 做 ; 如 果 你 想 获 取 整 个 对 象 ， 束 可 以 使 用 这 种 更 简洁 的 语法 。 











还 要 注意 的 是 ， 碍 询 是 按照 映射 的 Java 对 象 和 属性 来 表达 的 ， 而 不 
是 数据 表 和 列 。 在 这 个 例子 中 这 一 区 别 还 不 明显 ， 因 为 对 象 和 数据 表 的 
名 称 都 相同 ， 属 性 和 列 的 名 称 也 都 相同 ， 但 查询 确实 是 按照 对 象 和 属性 
来 表达 的 。 保 持 二 者 的 名 称 一 致 是 一 种 相当 自然 的 选择 ， 如 果 使 用 








Hibernate 来 生成 数据 库 模 式 和 数据 对 象 ， 结 果 也 总 是 这 样 ， 除 非 你 明确 
地 告诉 Hibernate 使 用 不 同 的 列 名 称 。 


当 你 使 用 的 是 以 前 就 有 的 数据 库 和 对 象 时 ， 就 应 该 特别 留意 HQL 查 
询 引 用 的 是 对 象 属性 ， 而 不 是 数据 库 表 的 列 。 








此 外 ， 束 像 在 SQL 中 一 样 ， 可 以 为 数据 库 表 和 列 起 其 他 的 别名 。 在 
HQL 中 ， 也 可 以 为 类 起 别名 ， 以 方便 选择 它们 的 属性 或 增加 约束 条 件 。 
当然 ， 在 这 个 简单 的 例子 中 不 会 看 到 这 种 用 法 ,但 是 如 果 你 深入 研究 附 
录 E 中 的 内 容 ， 肯 定 会 过 到 这 种 用 法 。 


多 这 个 程序 的 其 他 部 分 看 起 来 可 能 和 上 一 个 例子 类 似 。 这 里 我 们 简 
化 了 try 块 的 处 理 ， 因 为 没有 改变 任何 数据 ， 所 以 束 不 需要 显 式 地 访问 事 
务 。 我 们 仍旧 使 用 try 块 ， 这 样 就 能 够 有 一 个 finally 子 句 ， 以 清晰 地 关闭 
会 话 。 代 码 体 本 里 很 简单 ， 调 用 我 们 的 但 询 方法 以 请 求 播 放 时 间 小 于 或 
等 于 5 分 钟 的 所 有 曲目 ， 接 着 再 遍历 结果 中 的 Track 对 象 ， 分 别 打印 它们 
的 标题 和 播放 时 间 。 








既然 我 们 已 经 关 掉 了 Hibernate 内 部 "info" 级 别 的 日 志 输 出 ， 那 么 我 
们 在 hibernate.cfg.xml 中 配置 的 SQL 调试 输出 就 更 容易 定位 了 。 输 出 
中 "qtest:" 部 分 的 第 1 行 并 不 是 我 们 自己 在 QueryTest.java 中 编写 的 ， 我 们 
看 到 的 SQL 语 句 是 Hibernate 生 成 的 ， 以 实现 我 们 请 求 的 HQL 查 询 。 这 些 
内 幕 信 息 很 有 趣 吧 ! 如 果 你 对 这 些 信息 也 不 感 兴趣 ， 则 可 以 将 show_sql 





属性 设置 为 false， 束 不 会 看 到 它们 了 。 


其 他 


如 果 你 已 经 对 数据 创建 脚本 生成 的 数据 进行 了 修改 ， 现 在 又 想 清空 
数据 库 ， 以 一 种 “干净 的 状态 ”(clean slate) 来 进行 测试 ， 那 么 你 需要 做 
的 就 是 再 次 运行 ant schema 命 令 。 这 样 会 将 原 有 的 TRACK 表 完全 删除 ， 
并 重新 创建 新 的 TRACK 表 ， 使 其 处 于 最 原始 的 空 状 态 。 除 非 你 真 的 需 
要 这 样 ， 否 则 不 要 轻易 这 样 做 ! 








如 果 你 想 选 择 性 地 删除 一 些 数据 ， 则 或 者 通过 HSQLDB UI Cant 
db) 里 的 SQL 命 令 ; 或 者 先进 行 一 定 的 查询 ， 检 索 回 你 想 删 除 的 对 象 。 
在 取得 持久 化 对 象 的 引用 以 后 ， 可 以 将 该 对 象 的 引用 传递 给 Session 的 
delete O 方法 ， 这 样 就 可 以 将 它 从 数据 库 中 删除 了 : 





session.delete (aTrack) ; 


直到 aTrack 变 量 超出 其 作用 域 范围 《scope) 或 者 重新 赋值 以 前 ， 你 
的 程序 还 至 少 有 一 个 指 癌 这 个 被 删除 对 象 的 引用 。 因 此 ， 就 概念 上 而 
言 ， 理 解 delete() 方法 最 简单 的 方式 就 是 将 其 视 为 把 一 个 持久 化 对 象 
(persistent object) 转变 为 一 个 瞬时 对 象 (transient object) 。 


删除 对 象 的 另外 一 种 方法 就 编写 一 条 可 以 匹配 多 个 对 象 的 HQL 删 除 


查询 语句 。 这 样 可 以 一 次 性 删除 多 个 持久 化 对 象 ， 而 不 管 这 些 对 象 是 否 
在 内 存 中 ， 还 不 用 自己 写 循环 。 除 了 使 用 ant schema 命 令 ， 改 用 Java 方 
法 ， 以 较 “ 温 和 ”的 手法 来 清除 掉 所 有 曲目 时 ， 就 可 以 像 这 样 写 : 








Query query=session.createQuery ("delete from Track") ; 
gquery.executeUpdate () ; 











DREI, TOMER FATT IE, IRS SR Ah BS FS BE 
Hibernate 事 务 处 理 以 内 ， 如 有 果 想 让 修改 的 内 容 “* 固 定 ” 下 来 ， 就 得 提交 


(commit) 该 事务 。 





建立 查询 的 更 好 方法 


如 本 草 前 面 所 述 ，HQL 让 你 不 必 使 用 JDBC 风 格 的 查询 占 位 符 ， 就 
能 方便 地 将 参数 整合 到 但 询 中 。 可 以 使 用 命名 参数 (named parameter) 
和 命名 查询 (named query) 来 让 程序 更 易于 阅读 和 维护 。 








为 何在 意 


命名 参数 之 所 以 可 以 让 代码 更 容易 理解 ， 是 因为 不 省 在 查询 本 号 内 
部 ， 还 是 在 建立 碍 询 的 Java 代 码 内 部 ， 都 清晰 地 表达 了 参数 的 意图 。 这 
种 目 描述 性 《self-documenting ) 的 本 质 就 是 命名 参数 的 价值 万 在， 同时 
也 减少 了 引发 错误 的 淤 在 可 能 ， 因 为 使 用 命名 参数 时 ， 你 不 用 计算 SQL 
语句 中 逗号 和 问号 的 个 数 。 可 以 在 一 个 单独 的 查询 中 多 次 使 用 相同 的 参 
数 ， 这 样 在 一 定 程度 上 也 可 以 提高 程序 的 性 能 。 














命名 查询 可 以 将 查询 完全 从 Java 代 码 中 分 离 出 来 。 将 查询 语句 和 
Java 源 代码 分 离开 ， 会 使 其 更 易于 阅读 和 编辑 ， 因 为 查询 语句 不 再 是 原 
来 一 大 堆 路 越 多 行 的 Java 字 符 串 序列 ， 且 交织 着 大 量 的 问号 、 反 笠 线 以 
及 其 他 Java 标 点 符号。 第 一 次 输入 这 样 的 语句 是 相当 麻烦 的 ， 但 是 如 末 
你 需要 对 这 种 藤 入 在 程序 中 的 碍 询 做 重要 的 修改 时 ， 就 得 四 处 移动 问号 
和 加 号 ， 尽 可 能 让 语句 行 再 次 在 适当 的 位 置 断 开 。 





应 该 怎么 做 


对 于 Hibernate 而 言 ， 这 些 能 力 的 关键 就 是 Query 接 口 。 我 们 在 例 3-7 
中 就 已 经 使 用 过 这 个 接口 ， 因 为 从 Hibernate 3 开始 ，Query 接 口 是 惟 一 
Hibernate 不 反对 使 用 (nondeprecated) 的 执行 查询 的 接口 。 所 以 ， 和 本 
节 介 绍 的 其 他 功能 相 比 ， 现 在 更 容易 了 。 








我 们 先 修改 盘 询 语句 ， 使 用 命名 参数 ， 如 例 3-10 所 示 。〔 对 于 这 种 
只 有 单一 参数 的 查询 语句 而 言 ， 这 并 不 是 什么 难事 ， 但 宝 贯 的 是 从 现在 
起 就 养 成 正确 的 习惯 。 当 你 开始 为 实际 的 项 目 打造 一 大 堆 难 以 看 清 的 查 
询 语句 时 ， 你 会 很 感激 这 个 习惯 的 ! ) 








例 3-10: (EA We), BOA Ar SB 





public static List tracksNoLongerThan (Time length, Session 
session) { 

Query query=session.createQuery ("from Track as track"+ 

"where track.playTime<=: length") ; 

query.setTime ("length", length) ; 

return query.list () ; 


} 




















在 查询 语句 内 部 ， 命 名 参数 通过 在 它们 的 名 称 前 面 加 一 个 冒号 “:” 作 
为 标识 。 此 处 ， 我 们 将 “?” 号 蔡 换 为 ":length"。 会 话 对 象 提 供 了 一 个 
createQuery O 方法 ， 可 以 返回 一 个 Query 接 口 的 实现 ， 以 供 我 们 使 
用 。 为 了 设置 命名 参数 的 值 ，Query 提 供 了 一 整套 类 型 安全 的 方法 。 这 


里 ， 我 们 传递 的 是 一 个 Time 类 型 的 值 ， 所 以 我 们 使 用 了 setTime O 77 
法 。 即 使 在 如 此 简单 的 情况 下 ， 和 原来 的 查询 语句 相 比 ， 使 用 命名 参数 
以 后 的 语法 更 为 自然 和 方便 阅读 。 如 果 我 们 原来 传递 参数 使 用 的 是 值 和 
类 型 的 匿名 数组 (anonymous array) 〔 必 需 传 递 多 个 参数 ) ， 这 样 的 改 
进 束 显得 更 重要 了 。 此 外 ， 我 们 又 多 加 了 一 层 编译 时 (compile-time) 

的 类 型 检查 ， 这 总 是 很 受 开 发 人 员 欢 迎 的 调整 。 











运行 这 一 版 本 的 程序 产生 的 结果 和 原来 的 程序 完全 相同 。 


那么 ， 我 们 怎么 将 得 询 语 名 文本 放 到 Java 源 代码 以 外 呢 ? 同样 ， 这 
个 查询 太 简 单 了 ， 以 至 于 这 样 做 的 需要 不 像 在 实际 项 目 中 那样 令 人 印象 
深刻 。 但 是 ， 这 是 处 理 碍 询 语句 的 最 佳 方法 ， 所 以 开始 练习 吧 ! RS 
预料 的 那样 ， 我 们 存放 查询 语句 的 地 方 就 是 映射 文档 内 部 。 例 3-11 显 示 
了 映射 文档 中 的 碍 询 语 句 。 我 们 必须 使 用 有 点 符 重 的 CDATA 结 构 ， 因 
为 查询 语句 中 可 能 会 包含 一 些 破 坏 XML 解 析 器 处 理 的 字符 《例如 ， 
像 “<<” 这 样 的 字符 〉。 














例 3-11: 映射 文档 中 的 碍 询 语句 


<query name="com.oreilly.hh.tracksNoLongerThan"> 
<! [CDATA[ 

from Track as track 

where track.playTime<=: length 

] ] 人 > 

</query> 





Kee LE N AE Track.hbm.xml FRE MANAGE (</class> ) 
Za Cit#E</shibernate-mapping >#S—7T WAT) 。 然 后 ， 对 
QueryTest.java 做 最 后 一 次 修改 ， 如 例 3-12 所 示 。 同 样 地 ， 程 序 产生 的 结 
果 和 最 初版 本 完全 相同 ， 只 是 现在 组 织 得 更 好 。 如 果 我 们 需要 使 用 更 复 
杂 的 查询 ， 有 这 些 基 础 已 经 相当 好 了 。 


例 3-12: 碍 询 方法 的 最 终 版 本 





public static List tracksNoLongerThan (Time length, Session 
session) { 

Query query=session.getNamedQuery ( 

"com.oreilly.hh.tracksNoLongerThan") ; 

query.setTime ("length", length) ; 

return query.list ©); 


} 














除了 这 里 探讨 的 内 容 以 外 ，Query 接 口 还 有 很 多 其 他 有 用 的 功能 。 
可 以 使 用 接口 控制 要 取 回 多 少 条 记录 (并 可 以 指定 特定 的 记录 行 )。 如 
果 JDBC 驱 动 程序 支持 可 滚动 的 〈scrollable) ResultSet， 通 过 Query 接 口 
也 可 以 使 用 这 一 功能 。 相 关 更 多 的 细节 ， 可 以 查阅 JavaDoc 和 Hibernate 
的 参考 手册 。 





其 他 





完全 不 使 用 类 SQL 语言 ? 或 者 深入 HQL， 探 索 更 为 复杂 的 查询 ? 这 
两 种 方法 都 是 本 书后 面 将 要 介绍 的 内 容 。 








第 8 章 会 讨论 条 件 查 询 (criteria query) 。 条 件 查 询 是 一 种 很 有 趣 的 
机 制 ， 可 以 让 你 用 普通 的 Java API 表 达 出 想 要 对 实体 施加 的 限制 条 件 。 
这 样 就 可 以 构建 Java 对 象 来 表示 你 想 要 找到 的 数据 ， 对 于 非 数 据 库 专 家 
来 说 ， 这 种 方法 更 容易 理解 。 这 种 方法 还 可 以 让 你 利用 IDE 的 代码 完成 

(code completion) 功能 作为 一 种 辅助 编辑 方法 ， 甚 全 可 以 提供 编译 时 
的 语法 检查 。 此 外 ，Hibernate 还 文 持 一 种 “按照 例子 来 得 询 ”(query by 
example) 的 方法 ， 束 是 要 找 什么 对 象 ， 先 提供 与 之 类 似 的 对 象 例 子 。 
这 些 对 实现 应 用 程序 的 查询 搜索 接口 都 很 有 帮助 。 








想 多 看 点 HQL 的 SQL 老手 可 以 跳 到 第 9 章 ， 那 一 章 将 讨论 HQL 的 更 
多 其 他 能 力 和 独特 功能 。 就 目前 而 言 ， 接 下 来 我 们 要 继续 探索 对 象 / 关 
系 映 射 中 如 何 处 理 对 象 之 间 的 相互 关系 ， 这 在 任何 稍 复 杂 的 实际 应 用 中 
都 会 遇 到 。 











第 4 章 ”集合 与 关联 


不 ， 这 些 不 是 关于 理论 的 东西 。 我 们 已 经 看 到 让 单独 的 对 象 进出 数 
据 库 是 多 么 容易 ， 现 在 应 该 来 看 看 如 何 处 理 对 象 之 间 的 分 组 和 关系 。 令 
人 高 兴 的 是 ， 这 也 没什么 难 的 。 





集合 的 映射 


在 任何 真实 的 应 用 程序 中 ， 总 要 管理 对 象 的 列表 或 分 组 。Java 提 供 
了 一 套 健壮 而 功能 丰富 的 类 来 帮助 实现 这 些 应 用 : 集合 (Collection) T 
具 。 为 了 将 数据 库 关 系 映 射 到 集合 中 ，Hibernate 也 提供 了 一 些 很 目 然 的 
实现 方法 。 而 且 它 们 的 使 用 通常 也 非 党 方便。 不过， 你 得 注意 Java 集 合 
和 Hibernate 集 合 在 语义 上 的 一 些 普 别 ， 当 然 ， 这 些 差别 很 小 。 事 实 上 最 
大 的 差别 是 Java 集 合 没 有 提供 "bag"〈 包 ) 的 定义 ， 这 可 能 多 少 会 让 一 些 
经 验 丰 曲 的 数据 库 设 计 师 感到 失望 。 这 一 缺陷 并 不 是 Hibernate 的 错 ， 
Hibernate 甚 至 也 做 一 些 努 力 ， 以 作为 解决 这 一 问题 的 变通 方案 Cwork 








around) 。 
注意 : Bag 很 像 Set， 只 不 过 相同 的 值 可 以 多 次 出 现 。 


这 些 抽象 概念 就 点 到 为 止 ! Hibernate 参 考 手册 对 整个 bag 问题 已 经 
做 了 详尽 的 讨论 ， 所 以 我 们 在 这 里 不 做 介绍 ， 直 接 看 一 个 集合 映射 的 示 


例 〈 就 此 示例 而 言 ， 关 系数 据 库 和 Java 模 型 配合 得 相当 好 ) 。 在 第 2 章 
Track 示例 的 基础 上 继续 构建 新 的 功能 ， 将 曲目 分 组 成 专辑 (album) 看 
起 来 似乎 很 自然， 但 对 于 学 习 来 说 ， 这 并 不 是 最 简单 的 起 点 。 因 为 组 成 
专辑 需要 牵涉 到 记录 其 他 额外 的 信息 ， 例 如 曲目 是 从 哪 张 唱片 来 的 《对 
于 那些 包含 数 张 唱片 的 专辑 而 言 )， 以 及 其 他 类 似 的 细节 信息 。 所 以 ， 
我 们 先 把 艺人 (artist〉 的 信息 加 进 数 据 库 吧 。 





注意 : 和 以 前 一 样 ， 这 些 示例 假设 你 已 经 按照 前 几 章 的 步 又 做 好 了 
基础 工作 。 如 果 还 没有 ， 可 以 下 载 示例 的 源 代 码 作为 起 点 。 








要 记录 的 艺人 信息 相当 简单 ， 至 少 刚 开始 是 这 样 的 。 先 从 艺人 的 姓 
名 开始 。 可 以 为 每 个 曲目 分 配 一 组 艺人 人， 这样 ， 我 们 就 知道 应 该 找 谁 表 
示 感 谢 或 不 满 ， 还 可 以 找 出 你 喜欢 的 某 位 艺人 的 所 有 曲目 。《 人 允许 为 一 
个 曲目 分 配 多 位 艺人 是 相当 重要 的 ， 但 很 少 有 音乐 管理 程序 做 到 了 这 一 
点 。 痢 增加 一 个 链接 以 记录 曲目 的 作者 的 工作 惑 留 给 读者， 以 作为 读者 
理解 这 个 示例 之 后 的 练习 吧 。) 








应 该 怎么 做 


了 驶 目前 而 言 ， 我 们 的 Artist 类 只 需要 一 个 name 属 性 就 足够 了 C4 
然 ， 还 有 它 的 主键 属性 Gd) ) 。 为 它 建 立 映 射 文档 也 相当 容易 。 在 
Track 映射 文档 所 在 的 目录 中 创建 一 个 名 为 Artisthbm.xzml 的 文件 ， 其 内 


容 如 例 4-1 所 示 。 


例 4-1: Artist 类 的 映射 文档 





<?xml version="1.0"?> 


<! DOCTYPI 








Mapping DTD 3.0//EN" 


"http://hibernate. source! 
te-mapping> 
<class name="com.oreilly.hh.da 


<hibernat 











<meta at 


@author Jim 





</meta> 


<id name="id" 





tribute="class-descript 
Represents an artist who is ass 
Elliott (with help 








<meta a 


<generat 


</id> 
<proper 





type="int"column="ART 
ttribute="scope-set">protected</meta> 
tor class="native"/> 

















tion" > 





ta.Artist"table="ARTI 











<meta a 
<column 
null="true" 
</property> 


<set 





t name="tracks"table="TRACK ARTI 





ty name="nam 














ST 


"type="string">@ 


Dp" > 


use-in-tostring">true</meta> 

















<me 


>@ 


ta a 


ttribut 


1 





ttribute=" 
name="NAME"not- 
unique="tru 








<key column="ARTIST_ 
<many-to-many class="com.oreilly.hh.data.Track"column="TRACK_ID"/ 


</set> 
</class> 
</hibernate-mapping> 











ST 





D"/> 














"index="ARTIST NAME"/> 





E hibernate-mapping PUBLIC"-//Hibernate/Hibernat 


forge.net/hibernate-mapping-3.0.dtd"> 


ST"> 


ociated with a track or album. 
from Hibernate) 


[STS"inverse="true">@ 
ld-description">Tracks by this artist</meta 








@ 我 们 对 name 属 性 的 映射 引入 了 一 对 限制 标签 ， 分 别 用 于 配置 代码 
生成 和 模式 生成 过 程 。use-in-tostring 这 个 meta 标 签 会 让 生成 的 Java 类 包 
含 一 个 定制 的 toString〈) 方法 ， 用 于 在 输出 时 显示 艺人 的 名 字 ， 以 及 
神秘 的 散 列 码 (hash code) ， 以 辅助 调试 〈 生 成 结 末 如 例 4-4 底 部 所 


AX) 。 扩 展 column 的 各 属性 ， 使 其 成 为 一 个 更 加 完整 的 标签 ， 让 我 们 对 
列 属性 进行 更 细 粒 度 的 控制 。 在 这 个 例子 中 ， 我 们 用 这 个 标签 增加 了 一 
个 索引 ， 可 以 提高 按 艺 人 名 字 碍 询 和 排序 的 效率 。 








多 注意 ， 在 这 个 文件 中 我 们 可 以 很 自然 地 表达 一 个 艺人 与 一 个 或 多 
个 曲目 关联 的 事实 。 这 段 映 射 告诉 Hibernate， 为 Artist 类 增加 一 个 名 为 
tracks 的 属性 ， 它 的 类 型 是 java.util.Set 的 一 个 实现 。 这 会 使 用 一 个 新 的 名 
为 TRACK_ARTISTS 的 表 来 为 该 Artist 链 接 由 它 负 责 的 Track 对 象 。 属 性 
inverse=true 稍 后 在 例 4-3 的 讨论 中 再 详细 解释 这 种 关联 的 双向 性 的 本 
质 。 我 们 刚才 提 到 的 TRACK_ARTISTS 表 将 包含 两 列 : TRACK_ID 和 
ARTIST_ ID。 在 这 个 表 中 出 现 的 每 一 行 都 意味 着 指定 的 Artist 对 象 和 指 
定 的 Track 对 象 有 一 定 的 关系 。 将 这 种 关联 信息 单独 保存 在 它 自 己 的 表 
中 ， 这 样 就 不 会 限制 多 少 个 曲目 可 以 链接 到 一 个 特定 的 艺人 ， 也 不 会 限 
制 多 少 个 艺人 可 以 关联 到 一 个 曲目 。 这 就 是 所 谓 的 “多 对 多 ”关联 。 








劝 一 方面 ， 由 于 这 些 关 联 信 息 保 存在 一 个 单独 的 表 中 ， 要 获取 关于 
艺人 或 曲目 的 任何 有 意义 的 信息 ， 束 必须 执行 一 个 连接 查询。 这 也 就 是 
为 什么 称 这 样 的 表 为 “连接 表 ”(join table) 的 原因 。 它 们 的 所 有 目的 就 
是 为 了 连接 其 他 的 表 。 





最 后 要 注意 的 是 ， 不 像 我 们 用 数据 库 模 式 定 义 建立 的 其 他 表 ， 
TRACK_ARTISTS 表 没有 任何 相应 的 Java 对 象 。 它 只 是 用 于 实现 Artist 和 
Track 对 象 之 间 的 链接 ， 体 现 为 Artist 的 tracks 属 性 。 








全 除了 普通 的 值 类 型 字段 外 ，field-description meta 标 签 也 可 以 为 集 
合 和 关联 提供 JavaDoc 摘 述 。 当 字段 名 称 不 能 完全 目 动 文档 化 〈self- 
documenting) 时 ， 这 种 方法 就 很 方便 了 。 











如 果 对 连接 表 和 多 对 多 关联 之 类 的 概念 还 不 熟悉 ， 那 么 花 些 时 间 看 
看 数据 建 模 的 很 好 的 介绍 是 值得 的 。 对 这 些 概念 的 了 解 也 有 助 于 数据 驱 
动 的 项 目的 设计 、 理 解 以 及 交流 。George Reese 的 《Java Database Best 
Practices) (O'Reilly〉 就 有 这 样 的 介绍 ， 而 且 还 可 以 在 线 阅 读 这 本 书 的 
部 分 章节 ， 网 址 是 


http://www.oreilly.com/catalog/javadtabp/chapter/ch02.pdf. 


由 映射 文档 提供 的 调整 和 配置 选项 (尤其 是 使 用 meta 标 签 时 )， 为 
如 何 构 建 源 代码 和 数据 库 模 式 带 来 了 很 大 的 灵活 性 。 你 亲自 编写 这 些 配 
置 文件 所 获得 的 控制 能 力 ， 没 什么 可 以 与 之 相 比 ， 但 是 ， 对 于 大 多 数 需 
要 和 应 用 场合 来 说 ， 使 用 映射 驱动 Cmapping-driven) 的 生成 工具 就 已 
经 足够 了 。 这 些 生成 工具 的 一 个 最 大 优点 就 是 ， 它 们 可 以 免 去 你 输入 繁 
BA CURA! 创建 好 了 Artishbm.xml 文 件 以 后 ， 我 们 需要 将 它 添加 到 
hibernate.cfg.xml 的 映射 资源 部 分 。 在 src 目 录 中 打开 hibernate.cfg.xml 文 
件 ， 添 加 例 4-2 中 用 粗 体 字 显 示 的 那 一 行 。 





例 4-2: 将 Artist.hbm.xml 添 加 到 Hibernate 配 置 文 件 中 








<?xml version='1.0'encoding='utf-8'?> 
<! DOCTYPE hibernate-configuration PUBLIC 




















"_//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://hibernate. sourceforge.net/hibernate-configuration- 
3.0.dtd"> 
<hibernate-configuration> 
<session-factory> 























<mapping resource="com/oreilly/hh/data/Track.hbm.xml"/> 
<mapping resource="com/oreilly/hh/data/Artist.hbm.xml"/> 
</session-factory> 

</hibernate-configuration> 


























准备 好 后 ， 我 们 也 为 Track 类 增加 一 个 Artists 集 合 。 编 辑 
Track.hbm.xml 文 件 ， 添 加 一 个 新 的 artists 属 性 ， 如 例 4-3 所 示 “〈 新 添加 的 
内 容 以 粗 体 显示 ) 。 


例 4-3: 在 Track 映射 文件 中 增加 一 个 artist 集 合 





<property name="playTime"type="time"> 

<meta attribute="field-description">Playing time</meta> 

</property> 

<set name="artists”"table="TRACK ARTISTS" 

<key column="TRACK ID"/> 

<many-to-many 
class="com.oreilly.hh.data.Artist"column="ARTIST ID"/> 






























































</set> 

<property name="added"type="date"> 

<meta attribute="field-description">When the track was created 
</meta> 

</property> 








这 样 会 新 增加 一 个 名 为 artists 的 Set 类 型 的 属性 。 它 同样 使 用 例 4-1 提 
到 的 TRACK_ARTISTS 连 接 数 据 表 来 链接 到 我 们 所 映射 的 Artist 对 象 。 
这 种 双向 关联 (bidirectional association) 非常 有 有 用。 其中， 需要 将 关联 





的 一 端 标记 成 * 反 向 ”(inverse) ， 让 Hibernate 明 确 知道 完 竟 在 做 什么 ， 
这 一 点 很 重要 。 在 这 种 多 对 多 关联 的 情况 下 ， 虽 然 inverse 属性 可 以 影响 
Hibernate 在 什么 时 候 自 动 更 新 连接 表 ， 不 过 ， 选 择 哪 一 端 作为 反 转 映射 
并 不 重要 。 如 果 只 是 从 试图 理解 数据 库 的 人 的 角度 来 考虑 ， 既 然 将 连接 
数据 表 命 名 为 "TRACK_ARTISTS"， 也 就 表明 从 艺人 (ARTISTS 表 ) $ 
接 回 曲目 〈TRACK 表 ) 是 反 向 端的 最 佳 选择 。 





Hibernate 本 里 并 不 在 意 我 们 选择 哪 一 端 ， 只 要 我 们 将 其 中 一 端 标识 
为 inverse 就 可 以 。 我 们 在 例 4-1 中 就 是 这 样 配置 的 。 在 这 样 的 配置 下 ， 
如 果 我 们 对 Track 对 象 内 的 artists 集 合 做 出 了 修改 ，Hibernate 将 知道 它 需 
要 更 新 TRACK_ARTISTS 表 。 而 如 果 我 们 对 Artist 对 象 中 的 tracks 集 合 做 
出 了 修改 ，Hibernate 不 会 自动 更 新 。 


更 新 Track 映射 文档 时 ， 我 们 也 可 以 像 补 充 Artist 的 name 属 性 那样 ， 
来 充实 title 属 性 的 配置 : 





<property name="title"type="string"> 

<meta attribute="use-in-tostring">true</meta> 

<column name="TITLE"not-null="true"index="TRACK TITLE"/> 
</property> 












































有 了 这 个 更 新 过 的 映射 文件 ， 我 们 可 以 再 次 重新 执行 ant codegen 来 
更 新 Track 的 源 代 码 ， 并 创建 新 的 Artist 类 的 源 代码 。 如 果 你 得 看 
Track.java 文 件 ， 会 看 到 已 经 新 增加 了 一 个 类 型 为 Set 的 artists 属 性 ， 还 新 


增加 了 一 个 toString() 方法 。 例 4-4 是 新 的 Aristjava 的 内 容 。 


例 4-4: 为 Artist 类 生成 的 代码 





package com.oreilly.hh.data; 
//Generated Sep 3, 2007 10: 12: 45 PM by Hibernate Tools 3.2.0.b9 














import java.util.HashSet; 
import java.util.Set; 
/** 


*Represents an artist who is associated with a track or album. 
*@author Jim Elliott (with help from Hibernate) 

K 
public class Artist implements java.io.Serializable{ 
private int id; 

private String name; 

/** 
*Tracks by this artist 
*/f 
private Set tracks=new HashSet (0) ; 
public Artist () { 

} 
public Artist (String name) { 
this.name=name; 
} 
public Artist (String name, Set tracks) { 
this.name=name; 

this.tracks=tracks; 

} 
public int getId © { 

return this.id; 

} 

protected void setId (int id) { 
this.id=id; 

} 

public String getName () { 

return this.name; 

} 

public void setName (String name) { 
this.name=name; 

} 

/** 

**Tracks by this artist 

sy. 

public Set getTracks () { 







































































return this.tracks; 

} 

public void setTracks (Set tracks) { 
this.tracks=tracks; 

} 

/** 

*toString 

*@return String 


2 


















































public String toString () 4 
StringBuffer buffer=new StringBuffer () ; 
buffer.append (getClass () .getName () ) .append ("@") .append ( 














Integer.toHexString (hashCode () ) ) .append ("[") ; 

uffer.append ("name") .append ("='") .append (getName () ) .append ( 
uffer.append ("]") ; 

return buffer.toString () ; 








oO 














oO 


























注意 : 有 人 在 给 Hibernate 挑 毛病 吗 ? 修改 一 下 代码 生成 工具 ， 在 
toString ©) 方法 中 使 用 StringBuilder， 而 不 是 StringBuffer， 怎 么 样 ? 





为 什么 不 能 正常 运行 


如 果 你 看 到 Hibernate 报 告 以 下 几 行 信息 ， 先 不 要 失望 : 








[hibernatetool]An exception occurred while running exporter 
#2: hbm2java (Generates a set of.java files) 
[hibernatetool]To get the full stack trace run ant with-verbose 
[hibernatetool]org.hibernate.MappingNotFoundException: resource: 
com/oreilly/hh/data/Track.hbom.xml not found 

[hibernatetool]A resource located at 
com/oreilly/hh/data/Track.hbm.xml was not 

found. 
[hibernatetool]Check the following: 
[hibernatetool] 
[hibernatetool]1) Is the spelling/casing correct? 
[hibernatetool]2) Is com/oreilly/hh/data/Track.hbm.xml available 
via the c 

























































































lasspath? 
[hibernatetool]3) Does it actually exist? 
BUILD FAILED 


























这 只 是 因为 你 从 新 下 载 的 示例 目录 中 运行 程序 ，Ant 还 没有 准备 好 
类 路 径 (classpath〉 声 明 ， 我 们 以 前 在 第 2 章 的 2.3 节 讨论 过 这 个 问题 。 
如 果 你 再 试 着 运行 一 次 《或 者 在 第 一 次 运行 之 前 ， 先 手工 运行 一 次 ant 
prepare 命 令 ) ， 束 没有 问题 了 。 








其 他 


考虑 过 现在 (Java 5) 提倡 的 类 型 安全 〈type-safety) 的 问题 吗 ? H 
前 生成 的 这 些 类 使 用 的 都 是 Collections 类 的 非 泛 型 化 Cnongeneric) 版 
本 ， 用 当前 新 版 本 的 Java 编 译 占 来 编译 这 些 代码 时 ， 编 译作 会 报告 类 似 
以 下 的 信息 : 








[javac]Note: /Users/jim/svn/oreilly/hib dev_2e/current/scratch/ch0: 
/src/com/oreilly/hh/CreateTest.java uses unchecked or unsafe 
operations. 
[javac]Note: Recompile with-Xlint: unchecked for details. 

















如 果 有 办 法 可 以 生成 使 用 Java 泛 型 《Generics) 的 代码 ， 那 结果 一 
定 非常 棒 ， 这 样 就 可 以 加 强 对 放 入 tracks 集 合 〈Set) 的 东西 的 控制 ， 同 
时 也 避免 了 这 些 编译 警告 ， 也 不 用 像 原 来 使 用 Collections 时 ， 再 要 进行 
蒙 琐 的 类 型 转换 。 还 好 ， 非 常生 运 ， 只 要 修改 一 下 我 们 调用 hbm2java 的 
方式 ， 问 题 就 可 以 解决 了 。 编 辑 build.xml 文 件 ， 将 hmb2java 一 行 修改 为 


以 下 样子 : 





<hbm2java jdk5="true"/> 





这 是 在 告诉 生成 工具 ， 我 们 正在 使 用 Java 5《〈 或 更 高 版 本 ) ALG, 
这 样 就 可 以 利用 新 JDK 提 供 的 有 用 的 新 功能 了 。 经 过 这 一 修改 后 ， 再 次 
运行 ant codegen， 注 意 观 察 一 下 新 生成 的 代码 中 的 变化 ， 如 例 4-5 中 突出 


显示 的 部 分 所 示 。 


例 4-5: 用 jdk5 方 式 生 成 Artist 类 的 改进 





public Artist (String name, Set<Track>tracks) { 
this.name=name; 
this.tracks=tracks; 








public Set<Track>getTracks () { 
return this.tracks; 


} 
public void setTracks (Set<Track>tracks) { 


this.tracks=tracks; 











这 就 是 我 希望 看 到 的 代码 ， 使 用 Java 5 的 Collections 新 增 的 泛 型 功 
能 ， 漂 亮 地 实现 了 类 型 安全 的 集合 。 对 Track.java 中 的 artists 属 性 也 进行 
类 似 的 处 理 。 这 里 先 以 新 的 Track 类 “完整 ”(fuu) 构造 函数 作为 例子 ， 
稍 后 将 在 例 4-9 中 看 到 如 何 调用 该 构造 函数 : 





public Track (String title, String filePath, Date playTime, 
Set<Artist>artists, Date added, short volume) { 





注意 : 噢 ， 这 样 就 好 多 了 。 这 么 个 不 起 眼 的 配置 参数 ， 竟 人 带 来 这 么 
大 的 好 处 。 


在 这 个 新 的 构造 函数 中 ， 为 playTime 和 Data added 属 性 之 间 的 artists 
属性 创建 了 一 个 参数 化 的 Set 类 型 的 参数 。 





现在 已 经 创建 (或 更 新 ) 好 了 类 ， 我 们 就 可 以 使 用 ant schema 来 建 
立 文 持 它们 的 新 数据 库 模 式 了 。 





当然 ， 在 生成 源 代码 和 建立 数据 库 模 式 时 应 该 注意 有 没有 出 现 错误 
消息 ， 以 免 映 射 文档 中 有 任何 语法 或 概念 性 错误 。 不 过 ， 并 非 所 有 出 现 
的 异常 都 是 你 必须 解决 的 实际 问题 。 我 在 试验 如 何 改进 这 个 数据 库 模 式 
时 ， 遇 到 了 几 个 异常 ， 报 告 Hibernate 试 图 删除 以 前 运行 时 并 没有 建立 过 
的 外 键 (foreign key) 约束 。 模 式 生 成 工具 并 不 予以 理会 ， 而 继续 进行 
下 去 。 这 看 起 来 很 可 怕 ， 但 却 可 以 正常 运行 。 这 一 点 在 未 来 版 本 中 可 能 
会 有 所 改进 (Hibernate 或 HSQLDB， 或 者 也 许 只 是 修改 SQL 方言 的 实 
Dh) ， 不然， 也 要 学 着 忍受 这 些小 缺点 ， 它 们 已 经 存在 好 几 年 了 。 




















生成 的 数据 库 模 式 中 包含 我 们 期 待 的 数据 库 表 ， 其 中 有 一 些 索 引 和 
外 键 约束 的 设置 。 随 者 我 们 的 对 象 模 型 越 来 越 复杂 ，Hibernate 所 做 的 工 








作 量 《〈 以 及 专业 性 难度 ) 也 会 逐渐 增加 。 模 式 生 成 工具 的 完整 输出 相当 
元 长 ， 所 以 例 4-6 仅 列 出 一 些 重点 内 容 。 


例 4-6: 摘录 自 新 生成 的 数据 库 模式 的 部 分 内 容 














[hibernatetool]drop table ARTIST if exists; 
[hibernatetool]drop table TRACK if exists; 
[hibernatetool]drop table TRACK ARTISTS if exists; 
[hibernatetool]create table ARTIST (ART ST_ID integer generated by 

default 
as identity (start with 1) , NAME varchar (255) not null, 
primary key (ARTIST ID) , unique (NAME) ) ; 

[hibernatetool]create table TRACK (TRACK ID integer generated by 

default as 

identity (start with 1), TITLE varchar (255) not null, 
filePath varchar (255) not null, playTime time, added date, 
volume smallint not null, primary key (TRACK ID) ) ; 

[hibernatetool]create table TRACK ARTISTS (ARTIST ID integer not 

null, 
TRACK ID integer not null, primary key (TRACK _ID, ARTIST ID) ) ; 
[hibernatetool]create index ARTIST NAME on ARTIST (NAME) ; 
[hibernatetool]create index TRACK TITLE on TRACK (TITLE) 
[hibernatetool]alter table TRACK ARTISTS add constraint 
FK72EFDAD8620962DF foreign key (ARTIST ID) references ARTIST; 
[hibernatetool]Jalter table TRACK ARTISTS add constraint 
FK72EFDAD82DCBFAB5 foreign key (TRACK ID) references TRACK; 


























































































































































































































































































































酷 ! 我 甚至 还 不 知道 怎么 在 HSQLDB 中 做 这 些 事 ! 


图 4-1 是 新 增加 了 这 些 内 容 后 ， 数 据 库 模 式 在 HSQLDB 中 的 树 形 视 
图 。 我 不 确信 为 什么 为 世人 的 姓名 字段 (NAME 字 段 ) 要 用 两 个 单独 的 
索引 来 建立 惟一 性 约束 限制 ， 但 这 似乎 是 HSQLDB 本 吴 特 殊 的 实现 方 
法 ， 不 过 这 种 方式 运行 得 很 好 。 





B jdbcchsqidb:dara/music 
 ARTST 
schema: PUBLIC 
B ARTGT_ID 
Type: INTEGER 
Nullable: false 
& NAME 
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Nullabte: false 
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HE SYS_IDX_49 
| Unique: true 
一 ARTET_ID 
HE SYS_IDX_SYS_CT_48_§ 
Unique: true 
NAME 
E ARTGT_NAME 
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—NAME 
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图 41 更 新 数据 库 模 式 后 的 HSQLDB 树 状 图 形 界面 
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我 们 已 经 建立 了 一 个 对 象 模型 ， 让 Track 和 Artist 对 象 可 以 记录 彼此 
之 间 的 任何 一 组 关系 。 任 何 曲目 都 可 以 关联 到 任意 数目 的 艺人 ， 而 任何 
艺人 也 可 以 关联 任意 数目 的 曲目 。 要 将 这 种 模型 正确 地 建立 起 来 可 能 确 
实 不 容易 ， 尤 其 是 对 于 面 问 对 象 编程 或 天 系数 据 库 的 新 手 〈 或 者 二 者 都 
emi! ) ， 所 以 ， 有 Hibernate 的 帮助 真 的 很 好 。 但 是 等 一 下 ， 等 你 看 
到 用 这 样 建立 起 来 的 模型 来 处 理 数据 会 有 多 么 方便 时 ， 你 更 会 确认 这 一 











Wyo 


值得 强调 的 是 ， 艺 人 和 曲目 之 间 的 连接 关系 并 没有 保存 在 ARTIST 
表 或 TRACK 表 自 身 内 。 因 为 二 者 之 间 是 多 对 多 关联 ， 这 意味 着 一 位 艺 
人 可 以 关联 到 多 个 曲目 ， 而 一 个 曲目 也 可 以 关联 到 多 位 艺人 ， 这 些 连 接 
关系 都 保存 在 另 一 个 名 为 TRACK_ARTISTS 的 单独 的 连接 表 中 。 这 张 数 
据 库 表 中 的 每 一 条 记录 都 有 一 对 ARTIST_ ID 和 TRACK_ID， 用 于 代表 特 
定 艺 人 关联 到 特定 曲目 。 通 过 创建 和 删除 这 张 表 中 的 记录 行 ， 我 们 就 可 
以 建立 任何 需要 的 关联 模式 。〈 这 就 是 为 什么 多 对 多 关系 总 是 要 用 关系 
数据 库 来 表达 的 原因 所 在 。 前 面 提 到 的 《Java Database Best Practices》 
一 书 中 ，George Reese 对 这 种 数据 模型 有 很 好 的 介绍 。) 

















记 住 这 一 点 以 后 ， 你 也 会 注意 到 生成 的 类 不 包含 任何 用 于 管理 
TRACK_ARTISTS 表 的 代码 ， 而 后 面 用 于 创建 和 链接 持久 化 Track 和 





Artist 对 象 的 示例 也 没有 。 不 需要 这 样 的 操作 ， 是 因为 Hibernate 中 特殊 
的 Collection 类 会 利用 例 4-1 和 例 4-3 中 增加 的 映射 信息 来 为 我 们 处 理 好 这 
些 细节 。 好 了 ， 来 创建 一 些 曲 目 和 艺人 对 象 吧 。 


集合 的 持久 化 


我 们 的 第 一 个 任务 就 是 改进 CreateTest 类 : 利用 数据 库 模 式 中 新 增 


的 内 容 ， 创 建 一 些 艺 人 对 象 ， 并 为 它们 关联 上 一 些 曲 目 对 象 


应 该 怎么 做 


fe) 


首先 ， 在 CreateTest.java 中 增加 一 些 辅助 方法 ， 以 简化 我 们 的 任 


务 ， 如 例 4-7 所 示 《 修 改 和 新 增 内 容 以 粗 体 显 示 ) o 


例 4-7: 用 于 碍 找 和 创建 艺人 对 象 ， 并 将 它们 链接 到 曲目 对 象 的 工 


具 方 法 





package com.oreilly.hh; 





























for us. 








import org.hibernate.*; 

import org.hibernate.cfg.Configuration; 

import com.oreilly.hh.data.*; 

import java.sql.Time; 

import java.util.*; @ 

/** 

*Create more sample data, letting Hibernate persist it 


*/ 
public class CreateTest{ 
/** 
*Look up an artist record given a name. 

*@param name the name of the artist desired. 

*@param create controls whether a new record should be 
*the specified artist is not yet in the database. 



































created if 


*@param session the Hibernate session that can retrieve data 
*@return the artist with the specified name, or<code>null</code 














>if no 
*such artist exists and<code>create</code>is<code>{ 





false</code 


>, 
*@throws HibernateException if there is a problem. 
xA 
public static Artist getArtist (String name, boolean create, 
Session session) @ 
{ 
Query 
query=session.getNamedQuery ("com.oreilly.hh.artistByName") ; 
query.setString ("name", name) ; 
Artist found= (Artist) query.uniqueResult (); ® 
if (found==null& &create) {@ 
found=new Artist (name, new HashSet<Track> O ) ; 
session.save (found) ; 
} 
return found; 
} 
/** 
*Utility method to associate an artist with a track 
x. 
private static void addTrackArtist (Track track, Artist artist) 10 
track.getArtists () .add (artist) ; 
} 







































































和 人 处理 Hibernate 经 和 常 使 用 的 方法 一 样 ， 这 有 段 代码 相当 和 人 简单， 一 目 了 





@@ 我 们 前 面 导 入 过 java.util.Date， 但 现在 需要 导入 整个 util 包 ， 才 能 
使 用 Collection 接 口 。 粗 体 的 “*” 就 是 为 了 突出 这 一 点 ， 不 过 浏览 例子 时 
容易 忽略 它 。 


全 如 果 我 们 为 同样 的 艺人 创建 多 个 曲目 的 话 ， 则 和 希望 可 以 重用 同样 
的 数据 〈 这 就 是 使 用 Artist 对 象 ， 而 不 只 是 存储 字符 串 的 全 部 原因 ) 。 
getArtist O 方法 完成 按 名 字 人 查找 世人 的 功能 。 





@uniqueRusult O 方法 是 Query 接 口 的 一 个 方便 特色 ， 尤 其 适合 于 


以 下 情况 : 我 们 知道 查询 要 么 只 有 一 个 结果 ， 要 么 没有 任何 结果 。 这 样 
就 免 去 了 获取 结果 列表 、 检 查 列表 长 度 。 如 果 包 含 数据 的 话 ， 再 提取 第 
一 个 结果 元 素 ， 这 么 多 繁琐 的 步 又。 使 用 这 个 方法 要 么 只 取 回 一 个 结 
R, 或 者 当 没有 结果 时 ， 就 返回 null (如 果 查 询 返 回 多 个 结果 ， 这 个 方 
法 将 抛 出 一 个 异常 。 你 可 能 会 认为 我 们 在 列 上 施加 的 unique 约 束 能 够 防 
止 这 种 异 第 ,但 SQL 是 大 小 写 敏感 的 ， 而 我 们 的 伍 询 匹配 是 大 小 写 不 敏 
感 的 。 所 以 在 创建 一 个 新 记录 之 前 ， 应 该 忆 古 先 调用 getArtist() ， 以 
确保 同名 的 艺人 是 人 否 已 经 存在 ) 。 











@ 所 以 我 们 需要 做 的 就 是 检查 null 值 ， 如 果 没 有 找到 相应 名 字 的 艺 
人 ， 而 且 create 标 志 也 表明 我 们 想 要 创建 艺人 对 象 时 ， 就 创建 一 个 新 的 


Artist 。 


如 果 我 们 省 去 session.save〈) 调用 ， 那 么 所 有 艺人 Artist 对 象 将 保持 
瞬时 状态 。Hibernate 这 时 也 很 有 帮助 ， 如 果 我 们 试图 在 这 种 情况 下 提交 
事务 ，Hibernate 就 会 检查 到 持久 化 Track 实例 引用 了 了 瞬时 状态 的 Artist 实 
例 ， 从 而 抛 出 一 个 异常 。 你 可 以 回顾 一 下 第 3 章 对 生命 周期 的 讨论 ， 以 
及 第 5 章 的 “生命 周期 关联 ?”， 它 们 更 深入 地 探究 了 这 一 问题 。 


@addTrackArtist O 方法 兰 不 多 简单 得 令 人 和 十 从。 它 只 是 普通 的 
Java Collection 代 码 ， 获 取 属 于 某 个 Track 的 艺人 对 象 集合 〈Set) ， 再 将 
旨 定 的 Artist 深 加 到 这 个 集合 中 。 这 样 真 可 以 实现 我 们 需要 的 所 有 功能 
吗 ? 我 们 通常 不 得 不 写 的 数据 库 处 理 代码 都 跑 到 哪儿 去 了 ? 欢迎 来 到 对 





象 /关系 映射 工具 的 精彩 世界 ! 





可 以 看 到 getArtist ©) 方法 内 部 使 用 一 个 命名 查询 来 检索 Artist 记 
录 。 我 们 在 Artist.hbm.xml 的 末尾 添加 了 这 个 命名 查询 的 定义 ， 如 例 4-8 
所 示 。【〔 实 际 上 ， 可 以 将 命名 查询 放 在 任意 映射 文件 中 ,但 这 是 最 合适 
的 地 方 ， 因 为 这 个 查询 和 Artist 记 录 相 关 。 ) 





例 4-8: 在 Artist 映 射 文档 中 添加 检索 查询 语句 





<query name="com.oreilly.hh.artistByName"> 
<! [CDATA[ 

from Artist as artist 

where upper (artist.name) =upper (: name) 
11> 

</query> 





该 命名 查询 使 用 upper〈) 函数 对 艺人 的 姓名 进行 大 小 写 不 敏感 
(case-insensitive) 的 比较 ， 这 样 ， 即 使 查询 时 所 用 的 大 小 写 与 数据 库 
中 保存 的 数据 不 一 样 ， 也 可 以 检索 到 相应 的 艺人 。 这 种 不 区 分 大 小 写 ， 
但 又 能 保留 其 原 有 大 小 写 的 方法 是 一 种 用 户 友好 的 方法 ， 用 户 都 喜欢 这 
种 实现 方式 ， 所 以 值得 我 们 尽 可 能 实现 。 除 了 HSQLDB， 其 他 数据 库 中 
将 字符 串 转 换 成 大 写 的 函数 可 能 有 不 同 的 名 称 ， 但 应 该 都 有 。 我 们 将 在 
第 8 章 介 绍 一 种 面 同 Java 的 、 独 立 于 数据 库 的 方法 ， 以 一 种 漂亮 的 方式 
来 实现 这 种 字符 串 转 换 。 








现在 ， 我 们 以 此 为 基础 来 真正 创建 一 些 链接 了 艺人 的 曲目 对 象 。 例 


4-9 展 示 了 CreateTest 类 的 剩余 部 分 ， 新 增 部 分 以 粗 体 字 显示 。 按 照 示例 


所 演示 的 ， 编 辑 你 的 源 文件 (或 直接 下 载 以 节省 打字 时 间 〉。 


例 4-9: 修改 CreateTest.java 的 main〈() 方法 ， 增 加 艺人 关联 数据 








public static void main (String args[]) throws Exception { 
//Create a configuration based on the XML file we've put 
//in the standard place. 
Configuration config=new Configuration () ; 
config.configure © ; 
//Get the session factory we can use for persistence 
SessionFactory sessionFactory=config.buildSessionFactory () ; 
//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 
Transaction tx=null; 
try{ 
//Create some data and persist it 
tx=session.beginTransaction () ; 
Track track=new Track ("Russian Trance", 
"vyol2/album610/track02.mp3", 
Time.valueOf ("00: 03: 30") ， 
new HashSet<Artist> (), Q 
new Date (), (short) 0) ; 
addTrackArtist (track, getArtist ("PPK", true, session) ) ; 
session.save (track) ; 
track=new Track ("Video Killed the Radio Star", 
"vyol2/album611/track12.mp3"; 
Time.valueOf ("00: 03: 49") , new HashSet<Artist> O, 
new Date (), (short) 0) ; 
addTrackArtist (track, getArtist ("The Buggles", true, session) ) ; 
session.save (track) ; 
track=new Track ("Gravity's Angel", 
"vyol2/album175/track03.mp3", 
Time.valueOf ("00: 06: 06") , new HashSet<Artist> O, 
new Date (), (short) 0); 
addTrackArtist (track, getArtist ("Laurie Anderson", true, 
session) ) ; 
session.save (track) ; 
track=new Track ("Adagio for Strings (Ferry Corsten Remix) ", © 
"vyol2/album972/track01.mp3", 
Time.valueOf ("00: 06: 35") , new HashSet<Artist> O, 
new Date (), (short) 0) ; 
addTrackArtist (track, getArtist ("William Orbit", true, 






































































































































session) ) ; 






































addTrackArtist (track, getArtist ("Ferry Corsten", true, 
session) ) ; 
addTrackArtist (track, getArtist ("Samuel Barber", true, 











session) ) ; 
session.save (track) ; 
track=new Track ("Adagio for Strings (ATB Remix) ", 
"vyol2/album972/track02.mp3", 
Time.valueOf ("00: 07: 39") , new HashSet<Artist> O, 
new Date (), (short) 0) ; 
addTrackArtist (track, getArtist ("William Orbit", true, 
session) ) ; 
addTrackArtist 
addTrackArtist 
session) ) ; 
session.save (track) ; 
track=new Track ("The World'99", 
"vyol2/singles/pvw99.mp3", 
Time.valueOf ("00: 07: 05") , new HashSet<Artist> O, 
new Date (), (short) 0) ; 
addTrackArtist (track, getArtist ("Pulp Victim", true, session) ) ; 
addTrackArtist (track, getArtist ("Ferry Corsten", true, 
session) ) ; 
session.save (track) ; 
track=new Track ("Test Tone 1", @ 
"vyol2/singles/test01.mp3", 
Time.valueOf ("00: 00: 10") , new HashSet<Artist> O, 
new Date (), (short) 0) ; 
session.save (track) ; 
//We're done; make our changes permanent 
tx.commit () ; 
}catch (Exception e) { 
if (tx! =null) { 
//Something went wrong; discard all partial changes 
tx.rollback (©) ; 
} 
throw new Exception ("Transaction failed", e) ; 
finally{ 
//No matter what, close the session 
session.close () ; 
} 
//Clean up after ourselves 
sessionFactory.close () ; 
} 
} 


ee | 












































track, getArtist ("ATB", true, session) ) ; 
track, getArtist ("Samuel Barber", true, 
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例 4-9 对 现 有 程序 代码 的 修改 相当 有 限 : 





@@ 前 面 几 行 代码 用 于 创建 第 3 章 中 的 3 个 曲目 对 象 ， 这 里 只 需要 为 每 
个 曲目 对 象 提供 一 个 新 的 参数 来 作为 Artist 关 联 的 最 初 空 集合 。 随 后 每 
个 再 用 一 行 代码 来 为 曲目 建立 艺人 的 关联 。 我 们 原本 可 以 用 不 同 的 结构 
来 实现 这 段 代码 ， 编 写 一 个 工具 方法 以 创建 包含 艺人 对 象 的 最 初 的 
HashSet， 这 样 就 能 用 一 行 代码 完成 所 有 的 处 理 。 不 过 ， 对 于 多 艺人 的 
曲目 对 象 ， 我 们 实际 使 用 的 这 种 方法 的 适应 性 更 好 ， 下 一 节 将 演示 这 种 
情况 。 


全 最 大 一 段 新 代 码 是 简单 地 添加 了 3 个 新 的 曲目 ， 以 演示 如 何 处 理 
每 个 曲目 有 多 个 关联 艺人 的 情况 。 如 果 你 喜欢 电子 音乐 和 舞曲 《或 者 古 
典 首 乐 之 类 的 曲目 ) ， 就 应 该 知道 这 个 问题 多 么 重要 。 因 为 我 们 将 链接 
表达 为 集合 对 象 ， 所 以 维护 关联 就 简化 为 将 每 个 艺人 对 象 添加 到 相应 的 
曲目 对 象 就 可 以 了 。 


全 最 后 ， 我 们 添加 了 一 个 没有 艺人 关联 的 曲目 对 象 ， 看 看 会 发 生 什 
。 现 在 ， 你 可 以 运行 ant ctest 来 创建 新 的 样 例 数据 ， 其 中 包含 了 曲 
目 、 艺 人 以 及 他 们 之 间 的 关联 。 


六 





如 果 需 要 对 测试 数据 创建 程序 进行 修改 ， 又 想 再 次 从 空 数据 库 开 始 
运行 程序 ， 一 个 有 用 的 技巧 是 执行 ant schema ctest 命 令 。 这 个 命令 是 告 


诉 Ant 先 后 分 别 执行 schema 和 ctest 构 建 目标 。 执 行 schema 构 建 目 标 会 将 





现 有 数据 全 部 清空 ， 接 着 再 执行 ctest 以 重建 数据 。 


注意 : 当然 ， 现 实生 活 中 将 数据 放 到 数据 库 会 采用 其 他 做 法 一 通过 
用 户 界 面 或 将 实际 的 曲目 数据 直接 导入 数据 库 。 不 过 ， 如 果 只 是 单元 测 
试 ， 代 码 看 起 来 就 是 这 个 样子 。 


pa a fe ee 


运行 ctest 后 ， 除 了 Hibernate 使 用 的 SQL 语句 (如 果 仍 然 将 
hibernate.cfg.xml 中 的 show_sql 设 置 为 tue) ， 没 有 什么 非常 有 意义 的 输 
出 。 可 以 打开 data/music.script 来 看 一 看 里 面 新 创建 了 什么 ， 或 者 用 ant 

b 命 令 打开 数据 库 管 理 器 图 形 界面 来 查看 。 看 看 这 三 个 数据 库 表 的 内 

。 图 4-2 显 示 了 连接 表 中 代表 艺人 和 曲目 之 间 关 联 的 结果 。 原 始 数据 
已 经 隐藏 起 来 了 。 如 果 你 习惯 使 用 关系 数据 库 模型 ， 则 这 样 的 查询 结果 
表示 一 切 都 运行 正常 ， 如 果 你 和 我 一 样 都 是 几 人 ， 那 么 下 一 节 介 绍 的 内 
容 将 更 加 令 人 信服 ， 当 然 也 更 加 有 趣 。 














O jdbe:hsaldb:data/music 
日 ARTET 
—schema: PUBLIC 
-图 ARTT_ID 
国 NAME 
国 Indices 
-A TRACK 
schema: PUBLIC 
-E TRACKID 
- 国 TITLE 
国 FILEPATH 
国 PLAYTIME 
- 国 ADDED 
-E YOLUME 
-B Indices 
-A TRACK_ARTISTS 
schema: PUBLIC 
- 国 TRACKID 
-图 ARTIST_ID 
& Indices 





mb- 
Wn 





图 4-2 新 版 CreateTest 创 建 的 艺人 和 曲目 之 间 的 关联 


集合 的 检索 


新 增 


你 可 能 会 认为 从 数据 库 中 把 集合 信息 检索 出 来 同样 也 是 这 么 简单 。 
没 错 ! 这 一 节 将 改进 一 下 我 们 的 QueryTest 类 ， 把 艺人 及 相关 的 曲目 显 
示 出 来 。 例 4-10 以 粗 体 字 展示 了 适当 的 修改 和 增加 的 代码 。 而 且 只 需要 


少量 的 代码 。 





例 4-10: 改进 的 QueryTest.java( 以 便 显 示 关 联 了 曲目 的 艺人 对 象 ) 




































































package com.oreilly.hh; 

import org.hibernate.*; 

import org.hibernate.cfg.Configuration; 

import com.oreilly.hh.data.*; 

import java.sql.Time; 

import java.util.*; 

/** 

*Retrieve data as objects 

ua 

public class QueryTestf{ 

/** 

*Retrieve any tracks that fit in the specified amount of time. 

* 

*@param length the maximum playing time for tracks to be returned. 

*@param session the Hibernate session that can retrieve data. 

*@return a list of {@link Track}s meeting the length restriction. 

*y 

public static List tracksNoLongerThan (Time length, Session 
session) { 

Query query=session.getNamedQuery (人 

"com.oreilly.hh.tracksNoLongerThan") ; 

query.setTime ("length", length) ; 











return query.list () ; 


} 
/ 


* 


* 


大 类 





Build a parenthetical, comma-separated list of 





artist names. 











@param artists the artists whose names are to be displayed. 














*@return the formatted list, or an empty string if the set was 
empty. 
ae 
public static String listArtistNames (Set<Artist>artists) {@ 
StringBuilder result=new StringBuilder () ; 
for (Artist artist: artists) { 
result. append. © result: length: O) ==0) 2E (m; Wy nY; 
result.append (artist.getName () ) ; 
} 
if Cresult.length ©) >0) { 
result.append (") ") ; 
} 
return result.toString O) ; 
} 
/** 
*Look up and print some tracks when invoked from the command line. 
XY 
public static void main (String args[]) throws Exception{ 
//Create a configuration based on the XML file we've put 
//in the standard place. 
Configuration config=new Configuration () ; 
config.configure () ; 
//Get the session factory we can use for persistence 
SessionFactory sessionFactory=config.buildSessionFactory () ; 
//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 
try{ 
//Print the tracks that will fit in seven minutes 
List tracks=tracksNoLongerThan (Time.valueOf ("00: 07: 00"), @ 
session) ; 
for (ListIterator tterstracks<listlterator: () ; 
iter.hasNext ) ; ) { 
Track aTrack= (Track) iter.next () ; 
System.out.printin ("Track: \""4+aTrack.getTitle () +"\""+ 
listArtistNames (aTrack.getArtists © ) +® 
aTrack.getPlayTime () ) ; 
} 
























































































































































ae. 


finally{ 

//No matter what, close the session 
session.close () ; 

} 

//Clean up after ourselves 
sessionFactory.close () ; 

} 

} 


ee | 
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， 和 再 加 上 适当 的 空格 。 或 者 如 果 艺人 集合 为 空 的 话 ， 就 什么 也 不 显 





多 对 于 新 加 的 所 有 有 趣 的 多 艺人 相关 的 曲目 ， 其 播放 时 间 都 超过 
分 钟 ， 所 以 我 们 将 碍 询 限 值 增加 到 7 分 钟 ， 这 样 才 能 看 到 结果 。 


全 最 后 ， 我 们 在 println() 语句 的 适当 位 置 上 调用 
listArtistNames () 方法 ， 描 述 找到 的 曲目 信息 。 现 在 先 去 挥 Hibernate 
的 查询 调试 输出 配置 ， 因 为 这 些 调试 信息 会 妨碍 我 们 观察 真正 想 要 看 到 
的 信息 。 编 辑 src 目 录 下 的 hibernate.cfg.xml 文 件 ， 将 show_sql 属 性 修改 为 


false。 








<! --Echo all executed SQL to stdout--> 
<property name="show sql">false</property> 











这 样 设置 以 后 ， 例 4-11 演 示 了 执行 ant qtest 命 令 后 ， 新 的 输出 结果 。 


例 4-11: QueryTest 输 出 的 艺人 信息 





Sant qtest 

Buildfile: build.xml 

prepare: 

compile: 

[javac]Compiling 1 source file to/Users/jim/svn/oreilly/hib dev 2e 
/current/scratch/ch04/classes 

















qtest: 

[java]Track: "Russian Trance" (PPK) 00: 03: 30 

[ ]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 49 

[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06 
[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 

Corsten, 

illiam Orbit, Samuel Barber) 00: 06: 35 

[java]Track: "Test Tone 1"00: 00: 10 

BUILD SUCCESSFUL 

Total time: 2 seconds 
































你 会 注意 到 两 件 事 。 首 先 ， 可 以 看 到 这 种 结果 显示 方式 比 图 4-2 中 
简单 的 数字 列表 更 容易 解读 。 其 次 ， 运 行 无 误 ! 即使 不 带 任何 艺人 映射 
数据 、 纯 测试 用 的 “特殊 ”曲目 都 没有 问题 ， 因 为 Hibernate 采 用 的 方法 比 
较 友 好 ， 在 这 种 特殊 情况 下 会 创建 一 个 不 含 世 人 对 象 的 空 Set 对 象 。 免 
去 了 我 们 为 防止 引发 NullPointerException 〈 空 指针 错误 ) 异常 ， 而 自己 
编写 代码 检测 对 象 是 否 为 null 的 需要 。 











注意 : 但 是 ， 等 一 下 ， 还 有 呢 ! 不 需要 编写 额外 的 代码 


使 用 双 回 关联 


在 新 建 数据 的 代码 中 ， 我 们 简单 地 通过 把 Java 对 象 添 加 到 适当 的 集 
合 ， 就 建立 起 曲目 对 象 到 艺人 对 象 的 链接 。Hibernate 会 把 这 些 关 联 和 对 
象 分 组 转化 成 它 为 此 所 创建 的 连接 表 中 必要 的 隐 仿 项。 这样， 我 们 就 能 
用 简单 易 读 的 代码 来 建立 和 维护 这 些 关 联 关 系 。 但 是 要 记 住 ， 我 们 在 这 
里 创建 的 这 个 关联 是 双向 的 ，Artist 类 中 也 有 一 个 内 含 一 些 Track 对 象 集 
合 的 关联 。 不 用 烦恼 应 该 在 那 存储 什么 。 








这 种 设计 的 方便 性 在 于 ， 只 有 当 对 “主要 映射 ”(primary mapping) 
做 出 修改 时 ， 才 会 对 修改 传播 到 反 回 映射 器 。 如 果 只 对 反 回 上 映射 站 做 出 
修改 〈 就 此 例 而 言 ， 就 是 修改 Artist 对 象 中 保存 曲目 的 Set 集 合 对 象 ) ， 
那么 修改 结果 不 会 保存 下 来 。 可 惜 ， 这 就 要 求 你 在 代码 中 要 注意 哪个 映 
SY re JSC [A] RT ii o 











好 消息 是 我 们 不 用 为 此 而 必须 做 些 什 么 。 因 为 我 们 在 Artist 映 射 文 
档 中 将 这 个 关联 标识 为 反 向 映射 (inverse="true") ，Hibernate 知 道 当 为 
一 个 Track 对 象 新 增 一 个 Artist 关 联 时 ， 另 一 层 没 说 的 话 就 是 也 把 该 Track 
作为 关联 而 添加 给 了 那个 Artist。 


我 们 来 构建 一 个 简单 的 交互 式 图 形 应 用 程序 ， 以 帮助 检查 世人 对 曲 
目的 关联 链接 是 人 否 正确 。 这 个 应 用 程序 可 以 让 你 输入 艺人 的 姓名 ， 然 后 





显 出 与 该 艺人 相关 联 的 曲目 。 大 部 分 代码 和 第 一 个 查询 测试 程序 非常 类 
似 。 现 在 ， 创 建 QueryTest2.java 文 件 ， 并 输入 例 4-12 所 示 的 程序 代码 。 


例 4-12: QueryTest2.java 的 源 代码 





package com.oreilly.hh; 





























import org.hibernate.*; 

import org.hibernate.cfg.Configuration; 
import com.oreilly.hh.data.*; 

import java.sgql.Time; 

import java.util.*; import java.awt.*; 
import java.awt.event.*; 

import javax.swing.*; 

/** 


*Provide a user 
tracks. 


xy, 











interface to enter artist names and see their 





public class Qu 
List list; //Wi 














ryTest2 extends JPanel{ 
1l contain tracks associated with current artist 





efaultListModel model; //Lets us manipulate the list contents 








Build the panel containing UI elements 


public QueryTest2 () { 


setLayout (new BorderLayout () ) ; 
model=new DefaultListModel () ; 





list=new JList ( 











model) ; 





add (new JScrollPane (list) , BorderLayout.SOUTH) ; 
final JTextField artistField=new JTextField (28) : 














artistField.addKeyListener (new KeyAdapter () 10 
public void keyTyped (KeyEvent e) {9 











SwingUtilities.invokeLater (new Runnable O) 10 








public void run 


O { 





updateTracks (artistField.getText () ); 


} 
D; 
} 
D 


add (artistField, BorderLayout.EAST) ; 














add (new JLabel 





("Artist: ") , BorderLayout.WEST) ; 








} 
/** 


*Update the list to contain the tracks associated with an artist 


ay 

private void updateTracks (String name) {@ 
model.removeAllElements () ; //Clear out previous tracks 
if (name.length () <1) return; //Nothing to do 

try{ 
//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession O ; @ 

try{ 

Artist artist=CreateTest.getArtist (name, false, session) ; 

if Cartist==null) {//Unknown artist 

model.addElement ("Artist not found") ; 

return; 
} 
//List the tracks associated with the artist 

for (Track aTrack: artist.getTracks () ) {@ 
model.addElement ("Track: \""+aTrack.getTitle ©) + 
"\", "taTrack.getPlayTime () ) ; 

} 






























































finally{@ 

//No matter what, close the session 

session.close () ; 

} 

}catch (Exception e) { 

System.err.println ("Problem updating tracks: "+e) ; 
e.printStackTrace () ; 

} 

} 


private static SessionFactory sessionFactory; //Used to talk to 
Hibernate 


/** 

*Set up Hibernate, then build and display the user interface. 

af 

public static void main (String args[]) throws Exception { 

//Load configuration properties, read mappings for persistent 
classes 

Configuration config=new Configuration O ; O 

config.configure () ; 

//Get the session factory we can use for persistence 

sessionFactory=config.buildSessionFactory © ; 

//Set up the UI 
JFrame frame=new JFrame ("Artist Track Lookup") ; O 
frame.setDefaultCloseOperation (JFrame.EXIT_ON_CLOSE) 
frame.setContentPane (new QueryTest2 O ) ; 

frame.setSize (400, 180) ; 
frame.setVisible (true) ; 
} 
} 


a 














































































































注意 : 没 错 ， 这 是 露骨 的 推销 。 


示例 中 有 一 大 段 新 增 加 的 代码 用 于 建立 一 个 Swing 用 户 界面 ， 这 实 
际 上 还 是 个 相当 原始 的 界面 ， 无 法 漂亮 地 调整 窗口 大 小 。 但 是 ， 如 果 要 
处 理 这 些 界 面 效果 上 的 细节 ， 程 序 会 变 得 更 长 ， 其 实 这 些 内 容 也 不 是 本 
书 应 该 讨论 的 范围 。 如 果 你 想 看 一 些 如 何 建 立 丰 富 、 高 质量 的 Swing 界 
面 的 例子 ， 可 以 参考 《Java Swing) (O'Reilly, Second Edition) ， 这 是 
一 本 很 厚 的 巨著 ， 介 绍 了 Swing 界面 开发 的 方方面面 。 








加 在 构造 函数 中 我 想 重点 介绍 的 只 有 KeyListener， 要 将 它 加 到 
ee 

， 无 论 用 户 何 时 在 艺人 文本 框 中 输入 信息 ， 都 会 调用 这 个 匿名 类 的 
keyTyped ) 方法 。 








介 这 个 方法 检查 输入 文本 框 当前 是 否 包含 一 个 可 识别 的 世人 名 字 ， 
并 更 新 相应 的 曲目 显示 。 


全 不 幸 的 是 ， 在 调用 这 个 方法 时 ， 还 没有 更 新 文本 框 以 反映 最 新 的 
键盘 输入 ， 所 以 我 们 不 得 不 通过 SwingUtilities 的 invokeLater() 方法 将 
实际 的 显示 更 新 推迟 到 另 一 个 匿名 类 “(Runnable 的 实例 ) 中 。 这 种 技巧 
可 以 在 Swing“ 有 时 间 处 理 来 处 理 * 时 ， 再 进行 更 新 。 在 我 们 这 个 例子 中 
意味 着 文本 输入 框 将 自己 完成 更 新 。 


人 @ 在 用 户 输入 艺人 名 字 时 调用 的 updateTracks O 方法 正 是 有 趣 的 


Hibernate 处 理发 生 的 地 方 。 首 先 ， 这 个 方法 清理 干净 列表 ， 也 束 是 清除 
之 前 显示 过 的 任何 曲目 。 如 果 艺 人 名 字 为 空 ， 就 做 到 这 里 为 止 。 





否则 ， 这 个 方法 会 打开 一 个 Hibernate 会 话 ， 试 着 用 我 们 在 
CreateTest 里 所 写 的 getArtist O 方法 查找 艺人 信息 。 这 一 次 我 们 告诉 这 
个 方法 ， 如 果 找 不 到 相应 的 艺人 ， 就 不 要 创建 艺人 对 象 ， 所 以 如 果 用 户 
没有 输入 已 知 世 人 的 名 字 ， 就 会 得 到 一 个 null。 








@@ 另 一 方面 ， 如 果 确 实 找到 一 个 Artist 记 录 ， 则 遍历 该 艺人 的 所 有 
关联 曲目 集合 中 找到 的 Track 记录 ， 并 显示 每 个 曲目 的 相关 信息 。 这 将 
测试 逆 癌 (inverse) 关联 是 否 按照 我 们 的 预想 来 工作 。 


@ 最 后 (这 里 不 是 故意 用 双关 语 ) ， 要 确保 退出 该 方法 时 关闭 了 会 
话 ， 即 使 是 因为 异 第 而 退出 。 你 肯定 不 会 希望 发 生 会 话 泄 圳 ， 不 过 ， 如 
果 你 想 搞 垮 整个 数据 库 环 境 的 话 ， 这 束 是 个 好 方法 。 








@main O 方法 的 开始 还 是 相同 的 Hibernate 配 置 步 又， 我 们 以 前 就 
和 Is 
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结束 程序 。 显 示 这 个 界面 框架 后 ，main〈) 返回 ， 从 那 时 起 ， 就 由 
Swing 事件 循环 控制 后 续 流 程 。 


在 创建 〈 或 下 载 ) 好 代码 文件 以 后 ， 还 需要 在 build.xml (Ant 构 建 


文件 ) 的 末尾 新 增加 一 个 构建 目标 (如 例 4-13 所 示 〉， 才 能 够 调用 这 个 
新 创建 的 类 。 





注意 : 这 非常 类 似 于 现 有 的 qtest 构 建 目 标 ， 和 直接 复 制 、 调 整 一 下 就 
可 以 了 。 


例 4-13: 运行 新 的 查询 测试 程序 的 Ant 构 建 目 标 





<target name="qtest2"description="Run a simple Artist exploration 
GUI" 

depends="compile"> 

<java classname="com.oreilly.hh.QueryTest2"fork="true"> 

<classpath refid="project.class.path"/> 

</java> 

</target> 

















现在 ， 你 可 以 输入 ant qtest2 命 令 来 局 动 程序 ， 目 己 体验 一 下 这 个 程 
序 。 图 4-3 是 运行 中 的 程序 界面 ， 显 示 了 示例 数据 中 一 位 艺人 的 曲目 数 
PE o 











Track: “Adagio for Strings (Ferry Corsten Remix)", 00:06:35 
Track: “The World '99", 00:07:05 





A 4-3 非常 简单 的 艺人 曲目 浏览 器 








使 用 简单 集合 


到 目前 为 止 ， 我 们 所 看 到 的 集合 都 含有 和 其 他 对 象 之 间 的 关联 数 
据 ， 对 于 本 章 讨 论 的 “集合 和 关联 ”这 一 主题 来 说 ， 这 并 没有 什么 不 受 ， 
但 这 并 不 是 Hibernate 集 合 的 惟一 用 法 。 你 也 可 以 为 简单 值 的 集合 定义 映 
冉 ， 例 如 字符 串 、 数 字 以 及 非 持久 化 的 值 类 。 








应 该 怎么 做 


假设 我 们 想 为 数据 库 中 的 每 个 曲目 都 保存 一 定数 量 的 评论 ， 用 一 个 
名 为 comments 的 新 属性 来 记录 每 一 个 相关 联 评论 的 String 值 。 
Track.hbm.xml 中 的 新 映射 数据 看 起 来 很 像 原 来 我 们 为 艺人 映射 文档 所 做 
的 那样 ， 只 是 这 里 更 为 简单 〈 轴 ) 一 些 : 





<set name="comments"table="TRACK COMMENTS"> 
<key column="TRACK ID"/> 

<element column="COMMENT"type="string"/> 
</set> 











CEJ DOR CBAC BS fi J SCE RSC HF HP </class > K AEREE Z AI o 
TAR RARE Track IK) Piet PR BET SE, CIR A file) 


由 于 我 们 需要 为 每 个 Track 都 保存 任意 数量 的 评论 ， 所 以 我 们 得 为 
哇 一 个 专门 用 于 保存 评论 的 新 数据 库 表 。 每 个 评论 都 会 通过 每 个 曲目 的 


id 属性 链接 到 正确 的 Track 对 象 。 


用 ant schema 命 令 重 新 构建 数据 库 ， 以 下 显示 了 构建 过 程 的 内 容 : 





[hibernatetool]create table TRACK COMMENTS (TRACK ID integer not 
null, COMMENT 
varchar (255) ) ; 











[hibernatetool]16: 16: 55, 876 DEBUG SchemaExport: 303-alter table 
TRACK COMMENTS 

add constraint FK105B26882DCBFAB5 foreign key (TRACK ID) 
references TRACK; 












































注意 : 数据 建 模 者 一 般 将 这 种 关联 关系 称 为 “一 对 多 ”关系 。 


用 ant codegen 更 新 Track 类 之 后 ， 还 需要 在 CreateTest.java 中 每 次 调 
用 构造 函 数 时 ， 为 comments 属 性 增加 另 一 个 Set 对 象 。 例 如 : 





track=new Track ("Test Tone 1", 
"vyol2/singles/test01l.mp3", 

Time.valueOf ("00: 00: 10") , new HashSet<Artist> O, 
new Date (), (short) 0, new HashSet<String> O ) ; 








然后 ， 我 们 可 以 用 以 下 代码 行 来 指定 评论 内 容 : 





track.getComments () .add ("Pink noise to test equalization") ; 








执行 ant ctest AY UAR AIF IS {TIRE CHARAN BES 1 BE 
曲目 对 象 新 增加 第 二 个 专门 保存 字符 串 的 HashSet 对 象 )， 接 着 再 检查 
data/music.script， 看 看 数据 库 是 如 何 存储 评论 数据 的 。 或 者 ， 在 


QueryTestjava 中 输出 曲目 信息 的 printn O 之 后 再 多 加 一 个 循环 ， 以 打 
印 输出 刚刚 显示 过 的 曲目 的 评论 信息 : 





for (String comment: aTrack.getComments () ) { 
System.out.println ("Comment: "+comment) ; 


} 








接着 ， 运 行 ant qtest， 可 以 得 到 以 下 的 输出 : 





[java]Track: "Test Tone 1"00: 00: 10 
[java]Comment: Pink noise to test equalization 











当 工 具 让 简单 的 事情 变 得 更 容易 时 ， 那 真 的 很 好 。 下 一 章 我 们 会 看 
到 ， 即 使 是 复杂 的 事情 ， 也 是 畅通 无 阻 。 





[1] 如 果 要 将 这 些 示例 移植 到 Oracle 中 ， 必 须 修改 "COMMENT" 字 上 段 的 名 


称 ， 因 为 这 是 Oracle SQL 的 一 个 保留 字 。 还 有 很 多 类 似 的 标准 保留 字 ! 


Rot ”更 复杂 的 关联 











当然 啦 ， 多 个 朋友 多 条 路 。 但 是 这 并 不 简单 ， 所 以 应 该 探讨 一 下 对 
象 之 间 更 丰富 的 关系 ， 如 何 比 简单 的 分 组 携带 更 多 的 信息 。 在 本 章 中 ， 
我 们 将 要 探讨 一 下 如 何 将 曲目 组 合成 专辑 (album) 。 第 4 章 没 有 介绍 这 
一 点 ， 是 因为 组 织 专 辑 不 仅仅 是 简单 地 对 曲目 进行 分 组 ， 还 需要 知道 曲 
目 在 专辑 中 的 排列 顺序 ， 以 及 诸如 它们 在 哪 张 唱片 〈disc) 等 信息 ， 才 
能 支持 多 唱片 的 专辑 。 实 现 这 些 功 能 光 靠 自动 生成 的 连接 数据 库 表 是 不 
够 的 ， 所 以 我 们 得 自己 设计 AlbumTrack 对 象 和 数据 表 ， 才 可 以 把 专辑 和 
曲目 链接 起 来 。 











天 联 的 主动 加 载 和 延迟 加 载 


富 (rich) ， 而 后 主动 (eager) 和 延迟 Clazy) ? 这 些 词 听 起 来 
好 像 我 们 在 把 数据 模型 当成 鲜 活 的 人 物 来 介绍 。 但 这 其 实 是 O/R 映 射 的 
重要 主题 之 一 。 随 着 数据 模型 不 断 地 增长 ， 对 象 和 数据 库 表 之 间 的 关联 
也 会 随 之 增加 ， 程 序 的 功能 也 不 断 增多 ， 这 很 好 。 但 是 ， 通 常 最 后 的 结 
果 就 是 成 堆 的 对 象 之 间 被 链接 得 零 零 碎 碎 。 这 样 ， 当 从 一 大 串 彼 此 相关 
的 对 象 簇 中 加 载 一 个 从 属 的 对 象 时 ， 会 发 生 什 么 ?可 以 看 到 ， 只 要 通过 
遍历 对 象 的 属性 ， 就 可 以 从 一 个 对 象 访问 到 关联 的 另 一 个 对 象 。 这 似乎 
是 说 ， 当 需要 加 载 某 个 对 象 时 ， 就 得 必须 加 载 相 关联 的 所 有 对 象 。 对 于 


小 型 数据 库 来 说 ， 这 没有 什么 问题 《事实 上 ， 我 们 在 示例 中 使 用 的 
HSQLDB 数 据 库 只 是 在 运行 时 ， 才 全 部 存在 于 内 存 中 ) ; 但 是 一 般 情 况 
下 ， 应 用 程序 预定 的 数据 库容 量 肯 定 要 超过 程序 自身 占用 的 内 存量 。 
IE! 但 是 ， 即 使 真能 全 部 加 载 ， 也 不 太 可 能 真正 用 到 大 部 分 数据 对 象 ， 
所 以 ， 加 载 全 部 对 象 只 是 浪费 资源 而 已 。 














所 羊 ， 对 象 /关系 映射 软件 《包括 Hibernate 在 内 ) 的 设计 者 已 经 预 
见 了 这 个 问题 。 处 理 的 技巧 束 是 关联 配置 成 "lazy" 的 ， 这 样 ， 只 有 在 实 
际 需 要 访问 相关 联 对 象 的 引用 时 ， 才 会 加 载 相 应 的 对 象 。Hibernate 将 负 
责 维护 链接 对 象 的 标识 ， 直 到 真正 访问 它 时 ， 才 会 加 载 这 个 对 象 。 这 是 
我 们 经 党 使 用 的 集合 在 本 质 上 的 一 个 重要 特性 。 





应 该 怎么 做 


在 Hibernate 3 发 布 以 前 ， 关 联 在 默认 情况 下 并 不 设置 ljazy 属 性 ， 所 
以 必须 手工 在 映射 声明 中 设置 ljazy 属 性 。 不 过 ， 因 为 使 用 延迟 加 载 总 是 
最 佳 实 践 ， 所 以 Hibernate 3 就 默认 保留 了 lazy 的 设置 (进行 应 用 程序 移 
植 时 需要 特别 小 心 ， 绝 不 要 发 生 像 这 种 向 后 不 兼容 (backward- 


incompatible) 的 问题 ) 。 





当 对 象 的 关联 是 lazy 类 型 时 ，Hibernate 就 使 用 它 自 己 特殊 的 
Collections 类 的 延迟 加 载 实现 机 制 ， 直 到 试图 真正 使 用 集合 的 内 容 时 ， 


才 从 数据 库 中 加 载 相 应 的 内 容 。 这 些 处 理 是 完全 透明 的 ， 所 以 代码 编写 
者 并 不 会 注意 到 代码 背后 发 生 的 这 些 细节 。 


虽 ， 如 果真 是 这 么 简单 就 能 解决 加 载 大 量 相关 对 象 的 问题 ， 那 为 什 
么 还 要 将 这 个 设置 关 掉 呢 ? 问题 在 于 ， 当 你 关 掉 Hibernate 会 话 时 ， 这 种 
透明 性 就 消失 了 。 在 关 掉 会 话 后 ， 如 果 你 试图 访问 尚未 初始 化 的 延迟 加 
载 集合 (即使 将 这 个 集合 赋值 给 不 同 的 变量 ， 或 者 作为 方法 调用 的 返回 
值 )，Hibernate 提 供 的 代理 集合 (proxy collection) 也 将 不 再 访问 数据 
库 以 延迟 加 载 它 的 内 容 ， 而 是 强制 抛 出 一 个 LazyInitializationException 寞 
常 〈《 稍 后 我 们 将 介绍 如 果 确 实 需要 很 快 关 闭会 话 时 ， 应 该 如 何 处 理 ) 。 














注意 : 复杂 度 守 恒 看 起 来 很 像 热力 学 定律 。 


因为 这 种 无 法 预料 的 异常 与 Hibernate 特 定 的 程序 代码 本 身 没有 什么 
关系 ， 与 加 载 超过 实际 使 用 数量 的 对 象 而 付出 的 潜在 代价 相 比 ， 如 果 你 
认为 加 载 所 有 可 能 需要 使 用 的 对 象 更 为 重要 ， 那 么 就 可 以 关 挥 lazy 设 
置 。 你 要 负责 仔细 考 碟 在 什么 情况 下 需要 共用 这 一 设置 ， 如 果 使 用 lazy 
设置 的 话 ， 也 要 确保 安全 地 使 用 延迟 加 载 对 象 。Hibernate 参 考 手 册 中 深 
入 讨论 了 这 方面 的 选择 策略 。 


例如 ， 如 果 我 们 不 想 使 用 延迟 初始 化 ， 就 可 以 把 曲目 艺人 映射 文件 
按 例 5-1 所 示 的 方式 进行 设置 。 


例 5-1: 在 曲目 艺人 关联 中 使 用 主动 加 载 初始 化 











<set name="artists”"table="TRACK ARTISTS" lazy="false"— 

<key column="TRACK"/> 

<many-to-many 
class="com.oreilly.hh.data.Artist"column="ARTIST ID" /> 

</set> 

















其 他 


集合 以 外 延迟 加 载 的 用 法 ?缓存 (cache〉 和 和 集群 (cluster) ? 


延迟 加 载 集合 的 支持 机 制 很 容易 理解 ， 因 为 Hibernate 提 供 了 它 自己 
对 Collection 接 口 的 实现 。 


但 是 ， 对 于 其 他 类 型 的 关联 应 该 如 何 处 理 ? 其 他 类 型 的 关联 也 可 以 
受益 于 控 需 加 载 而 带 来 的 好 处 。 


事实 上 ，Hibernate 确 实 支持 ， 用 法 几乎 也 是 那么 简单 (至 少 从 服务 
的 使 用 者 来 看 确实 如 此 ) 。 同 样 ， 从 Hibernate 3 开始 ， 类 的 默认 加 载 方 
式 就 是 延迟 加 载 ， 不 过 ， 你 可 以 将 整个 持久 化 类 设置 为 ljazy="false" 来 关 
财 延 迟 加 载 〈 这 个 属性 就 放 在 映射 文档 的 class 标 签 中 ) 。 





当 采 用 延迟 加 载 的 方式 来 映射 一 个 类 时 ，Hibernate 将 生成 一 个 代理 
类 来 扩展 数据 类 (data class〉。 这 个 延迟 代理 类 会 推迟 加 载 数 据 的 时 
机 ， 直 到 真正 需要 使 用 数据 时 再 加 载 。 任 何 关 联 到 这 个 延迟 加 载 关 的 其 
他 对 象 都 会 悄悄 地 用 这 样 的 代理 对 象 进行 扩展 ， 而 不 是 引用 实际 的 数据 
对 象 。 当 第 一 次 使 用 代理 对 象 的 任何 方法 时 ， 才 会 加 载 真正 的 数据 对 

















象 ， 并 将 方法 调用 委托 给 数据 对 象 。 在 加 载 完成 数据 对 象 以 后 ， 代 理 对 
象 将 一 直 把 所 有 的 方法 调用 都 委托 给 它 。 如 果 想 做 的 再 花哨 点 ， 可 以 使 
用 proxy 属 性 来 指定 代理 类 将 要 扩展 (或 实现 ) 的 特定 类 (或 接口 )。 

lazy 属 性 是 将 持久 化 类 本 里 指 定 为 要 被 代理 的 类 的 快捷 方式 。 如果 看 
不 异 ， 也 别 担 心 ， 这 只 是 说 明 你 现在 还 不 需要 这 种 功能 而 已 。 当 你 需要 


Int, masta sc!) 








目 然 地 ， 在 会 话 关 闭 之 前 才能 加 载 需要 使 用 的 任何 东西 ， 这 一 限制 
依然 适用 于 这 种 延迟 加 载 类 的 初始 化 。 你 可 以 使 用 延迟 加 载 类 ， 但 这 样 
做 时 ， 一 定 要 小 心 慎重 ， 并 做 好 规划 。 


Hibernate 参 考 文 档 在 它 的 “提升 性 能 ”(Improving Performance) ( 
U) 一 章 中 深入 讨论 了 这 些 值得 权衡 的 考虑 。 也 介绍 了 Hibernate 甚 至 可 
以 和 JVM 层 或 集群 对 象 缓存 进行 集成 ， 以 减轻 数据 库 访问 的 瓶 贷 ， 提 升 
大 型 分 布 式 应 用 程序 的 性 能 。 当 集成 这 样 的 缓存 机 制 时 ， 可 以 在 映射 文 
档 中 用 cache 标 签 〈 足 够 恰当 ) 来 配置 类 和 关联 的 缓存 行为 。 这 些 配 置 
方法 不 在 本 书 讨论 的 范围 内 ， 但 是 你 应 该 注意 到 这 些 可 行 的 方法 ， 因 为 
说 不 定 你 的 应 用 程序 就 可 以 从 中 受益 。 








令 人 头痛 的 问题 


忽略 对 这 些 主题 的 讨论 ， 可 能 不 是 你 欣 芝 的 做 法 。 坦 白地 说 ， 理 解 





代码 执行 时 的 任何 路 径 上 需要 访问 的 对 象 集 的 边界 ， 在 优化 加 载 对 象 的 
同时 ， 还 不 会 浪费 太 多 的 内 存 和 开发 人 员 的 精力 ， 这 些 问题 都 是 O/R 映 
射 中 存在 的 最 困难 的 权衡 和 挑战 。 甚 至 像 Hibernate 这 样 优 秀 的 组 件 库 也 


不 完全 屏蔽 这 些 问 题 。 





羊 好 ， 有 些 技术 可 以 用 于 对 数据 访问 代码 进行 优化 ， 在 许多 凋 见 的 
应 用 场合 中 从 根本 上 避免 整个 问题 ， 从 中 你 可 以 理解 这 些 技术 得 以 流行 
的 原因 。 请 记 住 ， 只 有 在 关闭 Hibernate 会 话 之 后 再 去 访问 关联 对 象 时 ， 
延迟 加 载 的 关联 才 会 出 问题 。 如 果 在 会 话 打 开 期 间 可 以 完成 所 有 的 数据 
处 理 ， 那 么 延 人 运 加 载 的 关联 总 是 可 以 正常 工作 ， 不 必 为 它们 过 多 担心 。 








好 ， 那 么 在 程序 开始 运行 时 就 打开 会 话 ， 和 直到 程序 结束 再 关闭 会 
话 ， 这 样 可 以 吗 ? 哦 ， 不 ， 这 样 是 不 行 的 。 因 为 一 个 会 话 就 包括 了 一 个 
数据 库 事 务 (transaction) ， 而 数据 库 是 共享 资源 。 打 开 的 事务 被 保留 
的 时 间 越 长 ， 数 据 库 就 越 可 能 陷入 困境 ;， 辐 其 他 用 户 和 进程 隐藏 的 活动 
越 多 ， 这 些 活动 就 越 可 能 被 发 现 ; 当 你 最 终 提 区 事务 处 理 时 ， 也 惑 越 可 
能 与 其 他 事务 遇 到 冲突 。 所 以 ， 绝 对 不 要 在 等 竺 用 户 进行 操作 的 同时 而 
保持 打开 一 个 事务 。 








所 以 我 们 岂 不 就 是 遇 上 Catch-22 C17!) 了 ? 其 实情 况 并 没有 想象 中 
的 那么 坏 。 通 常 ， 只 要 应 用 程序 的 总 体 结构 设计 得 合理 ， 就 可 以 让 数据 
访问 发 生 的 位 置 一 目 了 然 ， 也 就 为 Hibernate 会 话 提供 了 开始 和 结束 的 自 
然 边界 。 例 如 对 于 Web 应 用 程序 ， 在 处 理 到 来 的 请 求 的 过 程 中 打开 





Hibernate 会 话 ， 这 样 做 很 有 意义 。 事 实 上 ， 开 发 人 员 经 常 建立 一 些 
Servlet 过 滤 露 (filter) 来 自动 完成 这 些 处 理 。 此 外 ， 如 果 有 些 后 台 任 务 
需要 定期 地 处 理 数据 (例如 在 夜间 友 送 电子 邮件 ) ， 它 们 残 可 以 在 类 似 
展 好 定义 的 边界 内 使 用 各 目 单 独 的 会 话 。 所 以 ， 虽 然 处 理 集 略 需 要 一 定 
的 技巧 而 且 也 很 重要 ， 但 困难 也 不 是 不 能 克服 的 。 我 们 将 在 第 13 革 和 第 
14 章 用 一 些 具体 的 示例 来 演示 一 些 不 错 的 方法 。 








[1] 

http:/ /www.hibernate.org/hib_docs/v3/reference/en/html/performance.html. 

D] ”这 个 词语 源 于 美国 著名 作家 约瑟夫 " 海 勒 的 成 名 作 《 第 22 条 军 规 》 
(Catch-22) ， 写 于 1961 年 ， 这 是 一 部 典型 的 黑色 幽默 之 作 。 在 当代 英 

语 中 Catch-22 作 为 一 个 独立 的 单词 ， 使 用 频率 非常 高 ， 用 来 形容 自 相 矛 

盾 、 不 合 远 辑 的 规定 ， 或 条 件 所 造成 的 无 法 脱身 或 左右 为 难 的 困境 。 


AFRA 





集合 排序 似乎 与 对 象 生命 周期 这 一 主题 有 些 偏离 ， 不 过 它 确 实 是 一 
个 重要 内 容 。 这 一 半 本 来 束 打 算 介绍 一 些 处 理 集合 映射 方面 的 有 趣 的 技 
巧 ， 所 以 我 们 就 言 归 正 传 ! 现在 我 们 的 首要 目标 是 存储 组 成 专辑 的 曲 
目 ， 并 保证 曲目 的 正确 顺序 。 稍 后 ， 我 们 再 加 入 曲目 所 属 的 唱片 ， 以 及 
曲目 在 该 唱片 的 位 置 等 信息 ， 这 样 才 可 以 妥善 地 处 理 包含 多 个 唱片 的 专 


辑 。 











注意 : Wa, Of, Abit re Beil eSB Se... 


应 该 怎么 做 





让 集合 内 容 保持 特定 的 顺序 其 实 相 当 人 简单 。 如 果 我 们 在 组 织 专辑 的 
曲目 时 只 在 乎 这 一 点 ， 那 么 只 要 告诉 Hibernate 映 射 到 一 个 List 或 Array 就 
可 以 了 。 例 5-2 演 示 了 专辑 (Album) 映射 中 我 们 使 用 的 方法 。 


例 5-2: 专辑 曲目 的 简单 排序 映射 


list name="tracks"table="ALBUM TRACKS" > 

key ee a /> 

list-index column="LIST POS"/> 

many-to-many class="com.oreilly.hh.data.Track"column="TRACK ID"/ 























< 
< 
< 
< 





</list> 
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这 与 我 们 一 直 在 用 的 set 映 射 十 分 相似 (虽然 这 里 使 用 了 一 个 不 同 的 
<<list 之 标签 以 标明 这 个 集合 是 个 有 序 的 列表 ， 因 此 该 集合 会 映射 到 一 
java.util.List) 。 但 是 要 注意 ， 我 们 也 必须 额外 增加 一 个 list-index 标 
签 ， 以 建立 这 个 列表 的 排序 字段 ， 同 时 ， 我 们 也 必须 在 数据 库 中 新 增加 
一 个 字段 来 保存 控制 曲目 顺序 的 值 。Hibernate 会 为 我 们 管理 这 个 字段 的 
内 容 ， 用 这 个 字段 来 确保 将 来 从 数据 库 把 列表 取出 时 ， 其 内 容 会 和 当初 
存储 到 数据 库 时 保持 相同 的 顺序 。 这 个 字段 的 类 型 是 整数 ， 可 能 的 话 ， 
可 以 将 它 作 为 该 数据 库 表 的 组 合 主键 (composite key) 的 一 部 分 。 当 生 
成 HSQLDB 数 据 库 模式 定义 时 ， 就 可 以 用 例 5-2 的 映射 内 容 来 生成 例 5-3 
所 示 的 数据 表 。 














例 5-3: 简单 有 序曲 目 列 表 的 HSQLDB 模 式 定 义 














[hibernatetool]create table ALBUM TRACKS (ALBUM D INTEGER not 

null, 
TRACK ID INTEGER not null, LIST POS INTEGER not null, 
primary key (ALBUM_ID, LIST POS) ) 







































































理解 LIST_POS 字 段 必 不 可 少 的 原因 是 很 重要 的 。 我 们 需要 控制 曲 
目 在 专辑 中 出 现 的 顺序 ， 但 是 曲目 自身 并 没有 任何 属性 可 以 让 我 们 确定 
它 在 专辑 中 的 顺序 〈 想 象 一 下 ， 如 果 播 放 器 只 能 以 字母 顺序 来 播放 专辑 
的 曲目 时 ， 你 会 多 么 失望 一 竟然 不 能 按照 曲目 的 艺人 顺序 播放 ) 。 关 系 
数据 库 系统 的 基本 特性 就 是 ， 检 索 得 到 的 顺序 是 系统 认为 方便 的 顺序 ， 
除非 指定 了 系统 应 该 如 何 对 结果 进行 排序 。LIST_POS 字 段 给 了 











Hibernate 一 个 它 可 以 进行 控制 的 值 ， 可 以 用 于 确保 列表 总 是 以 当初 创建 
的 顺序 进行 排序 的 。 另 一 种 思考 方式 是 ， 数 据 项 的 顺序 是 我 们 想 保存 下 
来 的 独立 信息 ， 所 以 Hibernate 需 要 有 个 地 方 来 保存 它 。 





随 之 而 来 的 结果 也 很 重要 。 如 果 数 据 中 有 些 值 可 以 提供 过 有 历 的 目 然 
顺序 ， 那 就 没有 必要 再 提供 一 个 索引 字段 (index column) ， 甚 至 也 不 
需要 使 用 list。set 和 map 集 合 映射 标 俭 就 提供 了 一 个 sort 属 性 ， 通 过 这 个 
属性 可 以 配置 用 于 在 Java 中 排序 的 字段 ， 或 者 数据 库 本 吴 也 提供 了 一 个 
用 于 排序 的 SQL order-by ji tE CH1) 。 无 论 哪 一 种 情况 ， 当 遍历 集合 的 
内 容 时 ， 都 能 以 特定 的 顺序 获得 其 内 容 。 


LIST_POS 字 段 中 的 值 总 是 与 传递 给 tracks.get〈) 方法 的 参数 值 相 
同 ， 该 方法 用 于 获取 tracks 列 表 中 茶 个 特定 位 置 上 的 值 。 


[1] 用 order-by 属 性 和 SQL 对 集合 进行 排序 的 功能 ， 只 有 Java SDK 1.4 或 更 
高 版 本 才 支 持 ， 因 为 这 需要 用 到 1.4 版 本 以 后 才 有 的 LinkedHashSet 或 
LinkedHashMap 类 。 





扩充 集合 中 的 天 联 





好 了 ， 如 果 我 们 想 把 专辑 中 的 曲目 按 一 定 的 顺序 排列 ， 现 在 已 经 有 

了 所 需要 的 解决 方法 。 那 么 ， 如 果 我 们 想 保存 其 他 信息 ， 应 该 怎么 办 ? 

例如 曲目 是 在 哪 一 张 唱片 中 找到 的 ? 当 我 们 映射 一 个 关联 的 集合 时 ， 我 

们 已 经 知道 Hibernate 会 创建 一 个 连接 表 来 存储 对 象 之 间 的 关系 。 此 外 ， 

我 们 也 知道 如 何在 ALBUM_TRACKS 表 中 增加 一 个 索引 字段 ， 以 保存 该 

合 元 素 的 顺序 。 理 想 情 况 下 ， 我 们 也 想 要 能 够 扩充 数据 表 的 内 容 ， 以 
填 入 我 们 自己 选择 的 信息 ， 以 便于 保存 专辑 曲目 的 其 他 细节 信息 。 











事实 上 ， 我 们 也 可 以 做 好 这 件 事 情 ， 而 且 过 程 也 很 简单 。 


应 该 怎么 做 





到 目前 为 止 ， 我 们 已 经 看 到 过 两 种 把 数据 表 放 进 数 据 库 模式 的 方 
法 。 第 一 种 方法 是 明确 地 将 Java 对 象 的 属性 映射 到 数据 表 的 字段 ;第 二 
种 方法 是 定义 一 个 集合 〈 值 或 关联 的 ) ， 并 指定 用 于 管理 这 个 集合 的 数 
据 表 和 字段 。 结 果 束 是 用 这 两 种 方法 创建 的 数据 表 的 使 用 是 一 样 的 。 可 
以 直接 用 该 数据 表 的 茶 些 字段 来 映射 对 象 的 属性 ， 而 同时 再 用 其 他 字段 
来 管理 集合 的 映射 。 这 样 可 以 让 我 们 在 实现 以 特定 的 顺序 来 保存 专辑 曲 
目的 同时 ， 还 能 够 通过 增加 其 他 细节 来 扩展 数据 表 ， 以 支持 包含 多 张 唱 








片 的 曲目 专辑 。 





TER: 这 种 赤 活 性 要 花 点 时 间 来 习惯 ， 不 过 有 其 道理 所 在 。 尤 其 是 
如 果 你 想 将 对 象 映 射 到 现 有 的 数据 库 模 式 时 。 


我 们 需要 一 个 新 的 数据 对 象 (AlbumTrack) ， 用 于 保存 有 关 曲 目 在 
专辑 中 的 使 用 方式 的 信息 。 由 于 我 们 已 经 实践 了 几 个 示例 ， 了 解 了 如 何 
映射 完整 而 独立 存在 的 实体 ， 因 此 AlbumTrack 对 象 实在 没有 必要 单独 存 
在 于 Album 实 体 的 范围 以 外 。 这 刚好 是 个 机 会 ， 可 以 看 一 看 组 件 映 射 是 
怎么 回 事 。 回 想 一 下 ， 在 Hibernate 的 术语 中 ， 实 体 就 是 在 持久 化 机 制 中 
独立 存在 的 对 象 : 它 可 以 被 创建 、 查 询 以 及 删除 ， 这 些 操作 都 独立 于 其 
他 任何 对 象 ， 因 此 有 其 自身 的 持久 化 身份 〈 表 现 为 它 必 须 具 有 id 属 
PE) 。 相 反 地 ， 组 件 虽 然 是 可 以 存储 到 数据 库 ， 也 能 从 数据 库 检 索 出 来 
的 对 象 ， 但 它 只 是 其 他 实体 的 从 属 部 分 。 在 这 个 示例 中 ， 我 们 要 把 一 组 
AlbumTrack 对 象 列 表 定 义 成 Album 实 体 的 组 件 。 例 5-4 就 是 定义 这 一 关 
系 的 Album 类 的 映射 文件 。 























例 5-4: Album.hbm.xml (Album 类 的 映射 定义 ) 





<?xml version="1.0"?> 

<! DOCTYPE hibernate-mapping PUBLIC"-//Hibernate/Hibernat 
Mapping DTD 3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 

<hibernate-mapping> 

<class name="com.oreilly.hh.data.Album"table="ALBUM" > 

<meta attribute="class-description"> 

Represents an album in the music database, an organized list of 
tracks. 












































@author Jim Elliott (with help 


</meta> 


<id column="ALBUM ID"name="id" 





from Hibernate) 























type="int"> 


<meta attribu te="scope-set" >protected</meta> 


<generat 
</id> 


or class="native"/> 





<property name="title"type="string"> 








<meta at 
<column 

</proper 
<propert 


<many-to 
class="com.o 
</set> 


tribute="use-in-tostring">true</meta> 

















ty> 











index="ALBUM TITLE"name="TITLE"not-null="true"/> 











y name="numDiscs"type="integer"/> 
<set name="artists"table="ALBUM ARTISTS"> 
<key column="ALBUM ID"/> 




















-many 











reilly.hh.data.Artist"column="ARTIST ID"/> 




















<set name="comments"table="ALBUM_COMMENTS" > 
<key column="ALBUM_ID"/> 
column="COMMENT"type="string"/> 


<element 
</set> 























<list name="tracks"table="ALBUM TRACKS">@ 





<meta at 
<key col 
<index c 
<composi 





umn="ALBUM ID" /> 
olumn="LI ST POS "/> 














tribute="use-in-tostring">true</meta> 


te-element class="com.oreilly.hh.data.AlbumTrack">@ 


<many-to-one class="com.oreilly.hh.data.Track"name="track" >@ 





<meta at 
<column 
</many-t 








name="TRACK ID"/> 
o-one> 


tribute="use-in-tostring">true</meta> 


<property name="disc"type="integer"/>@ 
<property name="positionOnDisc"type="integer"/>®@ 




















</composite-element > 

</list> 

<property name="added"type="dat 
<meta attribute="field-descript 
When the album was created</met 
</property> 

</class> 
</hibernate-mapping> 





te" > 
tion" > 
ta> 





在 创建 好 Album.hbm.xml 以 后 ， 还 需要 将 它 添加 到 hibernate.cfg.xml 
的 映射 资源 列表 中 。 打 开 src 目 录 下 的 hibernate.cfg.xml 文 件 ， 将 例 5-5 中 
用 粗 体 突出 显示 的 那 一 行 添 加 到 这 个 文件 中 。 


5-5: 将 Album.hbm.xml 琢 加 到 Hibernate 配 置 文件 中 








<?xml version='1.0'encoding='utf-8'?> 
<! DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://hibernate. sourceforge.net/hibernate-configuration- 
3.0.dtd"> 
<hibernate-configuration> 
<session-factory> 









































<mapping resource="com/oreilly/hh/data/Track.hbm.xml"/> 
<mapping resource="com/oreilly/hh/data/Artist.hbm.xml"/> 
<mapping resource="com/oreilly/hh/data/Album.hbm.xml1"/> 
</session-factory> 

</hibernate-configuration> 
































多 数 内 容 都 类 似 于 以 前 看 到 过 的 映射 配置 ， 但 是 tracks 列 表 的 配置 
值得 我 们 仔细 控 讨 。 关 于 讨论 的 内 容 ， 先 回想 一 下 刚才 我 们 完 竟 想 做 什 


Ao 


我 们 想 要 让 专辑 里 的 曲目 列表 保持 一 定 的 顺序 ， 同 时 又 能 为 每 个 曲 
目 增 加 一 些 额 外 的 信息 ， 以 指出 曲目 所 属 的 唱片 (专辑 包括 多 张 唱片 的 
情况 ) ， 以 及 该 曲目 在 唱 厂 中 的 位 置 。 这 种 关系 的 概念 如 图 5-1 的 中 部 
内 容 所 示 。 专 辑 和 曲目 之 间 的 关联 是 由 "AlbumTrack" 对 象 作 为 媒介 而 体 
现 的 ， 这 个 对 象 新 增加 了 唱片 和 位 置信 息 ， 并 保证 曲目 以 正确 的 顺序 排 
列 。 曲 目 对 象 本 里 的 模型 我 们 已 经 很 熟悉 了 此 图 中 ， 为 了 保持 简单 ， 
我 们 删 去 了 艺人 和 评论 信息 ) ， 这 个 模型 正 是 我 们 在 专辑 映射 文档 中 需 
要 使 用 的 〈“ 例 5-4) 。 让 我 们 讨论 其 中 的 细节 吧 。 稍 后 ， 我 们 会 介绍 
Hibernate 如 何 将 这 样 的 映射 配置 规定 转换 成 Java 代 码 〈 图 5-1 的 底部 部 











分 ) 和 数据 库 模 式 《〈 图 5-1 的 顶部 部 分 ) 。 


好 吧 ， 有 了 这 一 概念 性 框架 的 提示 和 摘 述 ， 我 们 接 下 来 残 看 看 例 5- 


@ 如 果 拿 前 一 章 的 集合 映射 定义 和 这 里 的 列表 定义 进行 比较 ， 你 会 
发 现 它们 之 间 存 在 很 多 相似 之 处 。 它 看 起 来 甚至 更 像 例 5-2， 只 是 关联 
映射 定义 已 经 移 到 一 个 新 的 composite-element 映 射 元 素 内 部 了 。 





四 这 个 元 素 引 入 新 的 AlbumTrack 对 象 ， 我 们 用 它 来 分 组 唱片 、 位 置 
以 及 组 织 专辑 曲目 所 需要 的 Track 链接 。 


母 此 外 ，AlbumTrack 和 Track 之 间 的 关联 是 多 对 一 的 《不 是 多 对 多 
的 映射 ， 因 为 专辑 通常 包含 数 个 曲目 ， 而 特定 曲目 文件 可 能 在 几 个 专辑 
之 间 共 享 ) : 如 果 我 们 为 了 节省 磁盘 空间 ， 几 个 AlbumTrack 对 象 “〈 来 自 
不 同 专辑 ) 可 能 会 引用 相同 的 Track 文件 ， 但 每 一 个 AlbumTrack 对 象 只 
与 一 个 Track 相关 。 包 含 AlbumTrack 的 list 标 签 隐 含 是 一 对 多 的 关系 〈 如 
果 这 些 数 据 建 模 概 念 让 你 很 困惑 ， 现 在 不 用 太 花 费 精力 去 和 弄 懂 这 些 ， 源 
代码 和 数据 库 模 式 马上 就 会 出 来 ， 希 望 有 助 于 你 明白 这 到 底 在 干 什 


AG ae 


好 了 ， 继 续 从 整体 上 考虑 一 下 这 个 新 的 composite-element 元 素 定 
义 。 这 个 元 素 指出 我 们 想 要 用 一 个 新 的 AlbumTrack 类 作为 Album 数 据 
bean 的 曲目 列表 中 的 值 。composite-element 标 签 的 主体 定义 了 





AlbumTrack 的 各 个 属性 ， 把 专辑 中 一 个 曲目 的 所 有 信息 都 汇集 在 这 儿 
了 。 这 些 租 套 属性 的 映射 语法 和 外 层 Album 自 喘 属性 的 映射 语法 并 没有 
什么 不 同 ， 甚 至 还 能 包含 自己 的 嵌 套 复合 元 素 、 集 合 或 meta 元 素 〈 如 此 
处 所 示 ) 。 这 让 我 们 在 建立 细 粒 度 的 映射 上 具有 相当 大 的 灵活 性 ， 同 时 
也 保留 了 一 定 良 好 程度 的 面向 对 象 的 封装 。 


在 我 们 的 复合 AlbumTrack 了 映射 中 ， 我 们 要 记录 和 实际 Track 之 间 的 
关联 (刚才 介绍 的 many-to-one 元 素 ) ， 以 及 该 曲目 在 专辑 中 的 播放 位 
置 。 








四 复合 映射 也 需要 保存 曲目 所 属 的 唱片 的 编号 。 














加 最 后 也 要 保存 该 曲目 在 唱片 中 的 位 置 《例如 第 2 号 唱片 的 第 3 首 曲 
FA). 


这 一 映射 取得 了 我 们 先前 的 既定 目标 ， 也 就 是 可 以 将 任意 的 信息 附 
加 到 关联 集合 中 。 


组 件 类 本 里 的 源 代码 如 例 5-6 所 示 ， 它 有 助 于 阐明 相关 讨论 。 可 以 
对 比 一 下 该 源 代码 和 它 的 图 形 表示 图 5-1 底 部 。 





汪汪 


number of discs 
when added 


Date 


a el 
tracks:List 


pas c:int 
rack.com.oreilly.hh. Track 





图 5-1 表示 专辑 曲目 所 涉及 的 数据 表 、 概 念 、 以 及 对 象 的 模型 


可 以 看 到 ， 我 们 选择 TRACK_ID 的 字段 名 称 作为 链接 到 TRACK 表 
的 多 对 一 Cmany-to-one) 关联 的 连接 字段 。 这 样 的 处 理 在 前 面 已 经 遇 到 
过 很 多 次 了 ， 但 之 前 都 不 需要 独立 成 一 行 。 这 里 值得 讨论 一 下 这 样 选 择 
的 原因 。 没 有 这 条 指令 ，Hibernate 将 只 会 用 属性 名 (track) 作为 字段 名 
称 。 你 的 字段 可 以 使 用 任何 名 称 ， 但 《Java Database Best Practices) — 
书 鼓 励 我 们 把 外 键 (foreign key) 字段 命名 成 和 其 引用 的 原来 数据 表 里 
的 主键 (primary key) 的 名 称 相 同 。 这 有 助 于 数据 建 模 工 具 识别 并 显示 
外 键 所 代表 的 “自然 连接 ” (natural join) ， 也 可 以 让 人 更 容易 理解 和 使 
用 数据 。 出 于 这 种 考虑 ， 我 们 就 将 数据 表 名 称 作为 主键 字段 名 称 的 一 部 


分 。 


me LS 


我 原本 以 为 ， 由 于 选择 使 用 composite 元 素来 封装 扩充 过 的 曲目 列 
表 ， 就 得 自己 编写 AlbumTrack 类 的 Java 源 代码 ， 而 这 会 超出 代码 生成 工 
具 能 力 所 及 的 范围 。 但 是 出 乎 意料 的 是 ， 当 我 试 着 执行 ant codegen 命 
令 ， 想 看 看 有 什么 错误 信息 会 出 现时 ， 没 想到 这 个 命令 居然 报告 成 功 ， 


源 代码 目录 下 出 现 了 Album.java 和 AlbumTrack.java 这 两 个 文件 ! 








注意 : 偶尔 证 明 是 错 的 也 不 为 过 。 


这 时 ， 我 再 回 过 头 来 为 组 件 内 曲目 的 多 对 一 映射 新 增 了 一 个 use-in- 
tostring 的 meta 元 素 。 我 不 确信 这 是 人 否 行 得 通 ， 因 为 我 在 参考 文档 中 惟一 
找到 的 使 用 示例 都 是 附加 在 property 标 签 以 内 。 但 是 居然 行 得 通 ， 这 和 
我 原来 希望 的 一 样 。 








Hibernate 节 佳 实践 或 励 我 们 使 用 细 粒 度 的 〈fine-grained) 持久 化 
类 ， 再 将 它们 映射 为 组 件 。 人 代码 生 成 工具 可 以 轻易 地 根据 映射 文档 来 创 
建 持久 化 类 的 源 代码 ， 绝 对 没有 借口 而 对 这 一 建议 视而不见 。 例 5-6 演 
示 了 为 舱 套 的 组 件 映射 生成 的 源 代码 。 








例 5-6: 为 AlbumTrack.java 生 成 的 代码 





package com.oreilly.hh.data; 

//Generated Jun 21, 2007 11: 11: 48 AM by Hibernate Tools 3.2.0.b9 

/** 

*Represents an album in the music database, an organized list of 
tracks. 

*@author Jim Elliott (with help from Hibernate) 


























public class AlbumTrack implements java.io.Serializable{ 
private Track track; 

private Integer disc; 

private Integer positionOnDisc; 

public AlbumTrack () { 



































public AlbumTrack (Track track, Integer disc, Integer 
positionOnDisc) { 
this.track=track; 
this.disc=disc; 
this.positionOnDisc=positionOnDisc; 
} 
public Track getTrack () 4 
return this.track; 
} 
public void setTrack (Track track) { 




















this.track=track; 

} 

public Integer getDise () { 

return this.disc; 

} 

public void setDisc (Integer disc) { 
this.disc=disc; 

} 
public Integer getPositionOnDisc () { 

return this.positionOnDisc; 

} 

public void setPositionOnDisc (Integer positionOnDisc) { 
this.positionOnDisc=positionOnDisc; 


























*toString 
*@return String 








public String toString ©) 4 
StringBuffer buffer=new StringBuffer () ; 

buffer.append (getClass () .getName () ) .append ("@") .append ( 
Integer.toHexString (hashCode () ) ) .append ("[") ; 

uffer.append ("track") .append ("='") .append (getTrack () ) .appenc 
buffer append ("]") ; 

return buffer.toString © ; 

} 

} 
























































oO 



































这 段 代 码 看 起 来 和 前 几 章 为 实体 生成 的 代码 差不多 ， 但 是 此 处 少 了 
一 个 id 属性 ， 这 是 有 道理 的 。 组 件 类 不 需要 标识 符 字 段 ， 也 不 需要 实现 
任何 特殊 接口 。 这 个 类 和 Album 类 共享 同样 的 JavaDoc， 而 在 Album 类 中 
就 使 用 了 该 组 件 类 。Album 类 的 源 代码 是 典型 的 代码 生成 工具 生成 的 实 
体 ， 所 以 这 里 不 再 袭 述 。 








现在 ， 我 们 可 以 通过 ant schema 命 令 为 这 些 新 的 映射 文档 建立 数据 
库 模 式 了 。 例 5-7 演 示 了 模式 创建 结果 的 重点 内 容 ， 这 就 是 图 5-1 顶 端 模 
式 模型 的 具体 HSQLDB 表 示 。 


例 5-7: 由 新 的 Album 映 射 所 增加 的 数据 库 模 式 











































































































[hibernatetool]create table ALBUM (ALBUM ID integer generated by 
default 
as identity (start with 1), TITLE varchar (255) not null, 
numDiscs integer, added date, primary key (ALBUM ID) ) ; 
[hibernatetool]create table ALBUM ARTISTS (ALBUM ID integer not 
null, 
ARTIST ID integer not null, 
primary key (ALBUM ID, ARTIST ID) ) ; 
e ALBUM COMMENTS (ALBUM ID integer not 











tetool]create tabl 


ID integer not 





BUM_ 








null, 
ENT varchar (255) ); 








BUM TRACKS (ALI 


























































































































































































































































































































[hibernatetool]create table ALI 
null, 
TRACK ID integer, disc integer, positionOnDisc integer, LIST POS 
integer not null, 
primary key (ALBUM ID, LIST POS) ) ; 
[hibernatetool]create index ALBUM TITLE on ALBUM (TITLE) ;¢ ..... 
[hibernatetool]Jalter table ALBUM ARTISTS add constraint 
FK7BA403FC620962DF 
foreign key (ARTIST ID) references ARTIST; 
[hibernatetool]alter table ALBUM ARTISTS add constraint 
FK7BA403FC3C553835 
foreign key (ALBUM ID) references ALBUM; 
[hibernatetool]Jalter table ALBUM COMMENTS add constraint 
FK1IE2C21E43C553835 
foreign key (ALBUM ID) references ALBUM; 
[hibernatetool]alter table ALBUM TRACKS add constraint 
FKD1CBBC782DCBFAB5 
foreign key (TRACK ID) references TRACK; 
[hibernatetool]alter table ALBUM TRACKS add constraint 
FKDLCBBC783C553835 
foreign key (ALBUM ID) references ALBUM; 











你 可 能 发 现 ， 对 数据 库 模 式 做 一 些 关 键 的 修改 会 导致 Hibernate 或 





HSQLDB3K A) FEF ACA VA. ARKH ALPII TER ET. HH H k 
SHIN, STRA PA ZR E CT PAR, TT 
Hibernate 在 试图 重新 建立 模式 时 并 不 知道 应 该 移 删 除 这 些 约 束 。 这 样 就 
不 能 继续 删除 和 重新 创建 作 些 数据 表 了 。 如 果 你 也 过 到 了 这 种 问题 ， 可 
以 先 删 除数 据 库 文件 (data 目 录 下 的 music.script 文 件 ) ， 再 从 头 开 始 ， 
应 该 就 没有 问题 了 。 针 对 这 些 情况 ，Hibernate 最 新 版 本 的 健壮 性 似乎 有 
所 增强 。 








图 5-2 展 示 了 HSQLDB 图 形 管理 界面 中 扩展 后 的 数据 库 柑 式 。 


你 可 能 会 问 ， 究 竟 为 什么 要 用 这 么 一 个 单独 的 Track 类 ， 而 不 是 直 
接 把 所 有 信息 都 放 在 扩充 后 的 AlbumTrack 集 合 中 。 答 案 很 简单 ， 并 不 是 
所 有 曲目 都 属于 某 个 专辑 ， 有 些 也 许 是 单 曲 、 下 载 而 来 的 或 其 他 单独 的 
曲目 。 既 然 我 们 已 经 用 一 个 单独 的 数据 表 来 记录 这 些 数 据 ， 所 以 再 在 
AlbumTracks 表 中 重复 其 内 容 而 非 建 立 与 Track 表 的 关联 ， 将 是 一 种 很 粳 
糙 的 设计 。 采 用 这 种 方法 《我 目 己 的 音乐 数据 库 就 是 用 这 种 方法 ) ， 还 
有 男 一 个 微妙 的 优点 ， 这 样 的 结构 能 让 我 们 在 多 个 专辑 中 共享 同一 个 曲 
目 。 如 果 有 专辑 、 精 选集 以 及 茶 个 或 多 个 年 代 的 选集 都 出 现 了 相同 曲 
目 ， 把 这 些 曲目 集 都 链接 到 相同 的 曲目 融 可 以 节省 磁盘 空间 。 











全 旺旺 HSQL Database Manager 


E jdbc:hsgldb:data/musiec 
E ALBUM 
schema: PUBLIC 
国 ALBUM ID 
国 TITLE 
E NUMDISCS 
困 ADDED 
f Indices 
E ALBUM_ARTISTS 
E ALBUM. COMMENTS 
E ALBUM TRACKS 
schema: PUBLIC 
国 ALBUM _ID 
E TRACK_ID 
E DEC 
f POSITIONONDBC 
S LIST_POS 
Indices 








E TRACK_ARTISTS 
TRACK COMMENTS 
f Properties 





图 5-2 专辑 相关 数据 表 的 模式 





ALBUM_TRACK 模 式 中 男 一 个 值得 注意 的 地 方 是 它 没 有 明显 的 ID 
字段 。 如 果 查 看 例 5-7 中 Hibernate 为 ALBUM_TRACK 生 成 的 模式 定义 ， 
可 以 看 到 主键 是 通过 primary key (ALBUM_ID, LIST_POS) 这 样 的 语句 
定义 的 。Hibernate 已 经 知道 ， 根 据 我 们 在 Album.hbm.xml 中 要 求 的 映射 
关系 ，ALBUM_TRACK 表 中 的 某 一 行 可 以 由 Album C4) 的 ID 和 曲 
目 在 列表 中 的 索引 而 惟一 确定 ， 所 以 Hibernate 为 这 个 表 建 立 了 一 个 复合 


主键 (composite key) 。 对 于 这 一 优化 ， 我 们 不 需要 过 多 讨论 。 还 要 注 


意 ， 这 些 列 中 有 一 个 类 型 是 AlbumTrack 类 的 属性 ， 而 其 他 列 则 不 是 。 在 





第 7 章 中 ， 我 们 将 以 为 一 种 稍微 不 同 的 方式 来 建立 这 一 关系 模型 。 


我 们 来 看 看 示例 程序 代码 ， 以 了 解 如 何 使 用 这 些 新 的 数据 对 象 。 例 
5-8 演 示 的 类 会 创建 一 个 专辑 记录 和 一 列 曲目 ， 然 后 通过 配置 好 的 
toString O 方法 来 打印 输出 测试 调试 数据 。 


例 5-8: AlbumTest.java 的 源 代码 





package com.oreilly.hh; 




































































import org.hibernate.*; 

import org.hibernate.cfg.Configuration; 

import com.oreilly.hh.data.*; 

import java.sql.Time; 

import java.util.*; 

/** 

*Create sample album data, letting Hibernate persist it for us.*/ 

public class AlbumTest { 

/** 

*Quick and dirty helper method to handle repetitive portion of 
creating 

*album tracks.A real implementation would have much more 
flexibility. 

*/ 

private static void addAlbumTrack (Album album, String title, 
String file, 

Time length, Artist artist, int disc, 


int positionOnDisc, Session session) 10 











Track track=new Track (title, file, length, new HashSet<Artist> 
EJ 

new Date (), (short) 0, new HashSet<String> O ); 

track.getArtists () .add (artist); 四 


session.save (track) ; 

album.getTracks () .add (new AlbumTrack (track, disc, 
positionOnDisc) ); @} 

public static void main (String args[]) throws Exception { 

//Create a configuration based on the properties file we've put 




















//in the standard place. 

Configuration config=new Configuration () ; 

config.configure © ; 

//Get the session factory we can use for persistence 
SessionFactory sessionFactory=config.buildSessionFactory () ; 
//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 

Transaction tx=null; 

try{ 

//Create some data and persist it 
tx=session.beginTransaction () ; 

Artist artist=CreateTest.getArtist ("Martin L.Gore", true, 
session) ; 

Album album=new Album ("Counterfeit e.p.", 1, 

new HashSet<Artist> O , new HashSet<String> () ， 

new ArrayList<AlbumTrack> (5) , new Date () ) ; 
album.getArtists () .add (artist) ; 

session.save (album) ; 










































































addAlbumTrack (album, "Compulsion", "voll/album83/track01.mp3", 
Time.valueOf ("00: 05: 29"), artist, 1, 1, session) ; 
addAlbumTrack (album, "In a Manner of Speaking", 
"voll/album83/track02.mp3", Time.valueOf ("00: 04: 21") , 

















artist，1，2，session) ; 
addAlbumTrack (album, "Smile in the Crowd", 
"voll/album83/track03.mp3", Time.valueOf ("00: 05: 06") , 
artist, 1, 3, session) ; 
addAlbumTrack (album, "Gone", "voll/album83/track04.mp3", 
Time.valueOf ("00: 03: 32") , artist, 1, 4, session) 4 
addAlbumTrack (album, "Never Turn Your Back on Mother Earth", 
"voll/album83/track05.mp3", Time.valueOf ("00: 03: 07"), 
artist, 1, 5, session) ; 
addAlbumTrack (album, "Motherless 

Child", "voll/album83/track06.mp3", 
Time.valueOf ("00: 03: 32") , artist, 1, 6, session) ; 
System.out.println (album) ; 
//We're done; make our changes permanent 
tx.commit () ; 
//This commented out section is for experimenting with deletions. 
//tx=session.beginTransaction () ; 
//album.getTracks () .remove (1) ; 
//session.update (album) ; 
//tx.commit O) ; 
//tx=session.beginTransaction () ; 
//session.delete (album) ; 
//tx.commit O) ; 
}catch (Exception e) { 

if (tx! =null) { 

//Something went wrong; discard all partial changes 
















































































tx.rollback () ; 
} 
throw new Exception ("Transaction failed", e); 
}finally{ 
//No matter what, close the session 
session.close () ; 

} 

//Clean up after ourselves 
sessionFactory.close () ; 

} 

} 


























各 首先 ，addAlbumTrack O 方法 会 根据 指定 的 参数 创建 一 个 Track 
对 象 ， 并 将 之 持久 保存 。 


@ 其 次 ， 将 新 的 曲目 和 一 个 Artist 对 象 建立 关联 。 








全 最 后 ， 将 曲目 对 象 加 到 Album 内 ， 记 录 所 属 的 唱片 以 及 在 该 唱片 
中 的 位 置 。 


在 这 个 示例 中 ， 我 们 创建 了 一 个 只 有 一 张 唱片 的 专辑 。 虽 然 这 种 快 
速 而 简单 的 方法 并 不 能 处 理 其 他 各 种 应 用 需求 ， 但 这 样 可 以 让 示例 更 简 


iat 


为 了 调用 这 个 类 ， 还 需要 在 build.xml 的 末尾 增加 一 个 新 的 ant 构 建 目 
标 ， 将 例 5-9 的 内 容 添 加 到 该 文件 的 结尾 处 〈 当 然 ， 应 该 在 project 元 素 的 
内 部 ) 。 


例 5-9: 运行 AlbumTest 类 需要 的 ant 构 建 目 标 





<target name="atest"description="Creates and persists some album 





data" 
depends="compile"> 
<java classname="com.oreilly.hh.AlbumTest"fork="true"> 
<classpath refid="project.class.path"/> 
</java> 
</target> 











准备 好 以 后 ， 假 定 已 经 生成 了 数据 库 模 式 ， 接 着 就 依次 执行 ant 
ctest 和 ant atest《〈 先 运行 ctest 并 不 是 必需 的 ， 但 是 ， 测 斌 开始 时 有 些 额 外 
的 数据 ， 会 让 专辑 数据 变 得 更 有 趣 些 。 回 想 一 下 ， 你 也 可 以 只 用 一 行 命 
令 来 运行 这 些 构 建 目标 : ant ctest atest。 如 果 想 在 开始 时 先 把 数据 库 的 
内 容 清 除 掉 ， 则 可 以 执行 ant schema ctest atest) 。 这 个 命令 产生 的 调试 
输出 信息 如 例 5-10 所 示 。 虽 然 有 些 难 懂 ， 但 是 应 该 可 以 看 出 来 这 段 代 码 
创建 好 了 专辑 和 曲目 数据 ， 而 且 还 保留 了 曲目 的 顺序 。 








例 5-10: 运行 专辑 测试 的 输出 





atest: 

[java]com.oreilly.hh.data.Album@5bcf3a[title='Counterfeit 
e.p.'tracks=' [ 

com.oreilly.hh.data.AlbumTrack@6a346a[track='com.oreilly.hh.data.T 


























title='Compulsion'volume='Volume[left=100, 
right=100] 'sourceMedia='CD']'], c 
om.oreilly.hh.data.AlbumTrack@8e0el [track='com.oreilly.hh.data.Tra 








tle='In a Manner of Speaking'volume='Volume[left=100, 
right=100] 'sourceMedia=' 

CD Ts 
com.oreilly.hh.data.AlbumTrack@de59f0[track='com.oreilly.hh.data.Trac 

k@e2d159[title='Smile in the Crowd'volume='Volume[left=100, 
right=100] 'source 

Media='CD']'], 
com.oreilly.hh.data.AlbumTrack@le5a36[track='com.oreilly.hh.da 

ta.Track@b4bb65[title='Gone'volume='Volume[left=100, 
right=100] 'sourceMedia=' 

CD] ls 
com.oreilly.hh.data.AlbumTrack@7b1683 [track='com.oreilly.hh.data.Trac 





























k@3171 











e[title='Never Turn Your Back on Mother 
Earth'volume='Volume[left=100, r 
ight=1 








00] 'sourceMedia='CD']'], 


com.oreilly.hh.data.AlbumTrack@e2e4d7 [track=' 
com.oreilly.hh.data.Track@ldfc6e[title='Motherless 
Child'volume='Volume [left=] 
00, right=100] 'sourceMedia='CD']']]'] 























如 果 执 行 原来 的 查询 测试 ， 会 同时 看 到 新 旧 数 据 ， 如 例 5-11 所 示 。 


例 5-11: 无 论 是 否 来 自 专辑 ， 所 有 曲目 的 播放 时 间 都 小 于 7 分 钟 





Sant qtest 








Buildfile: build.xml] 





] Track: "Russian Trance" (PPK) 00: 03: 30 
]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 


49[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06 








] Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 





Barber, William Orbit) 00: 06: 35 








ava] 
21[j 
ava] 


Lu. M a.u. u. u- 











[java] 
L.Gore) 
00: 03 


]Track: "Test Tone 1"00: 00: 10 
]Comment: Pink noise to test equalization 
]Track: "Compulsion" (Martin L.Gore) 00: 05: 29 





Track: "In a Manner of Speaking" (Martin L.Gore) 00: 04: 





va]Track: "Smile in the Crowd" (Martin L.Gore) 00: 05: 06 


Track: "Gone" (Martin L.Gore) 00: 03: 32 
Track: "Never Turn Your Back on Mother Earth" (Martin 











: 07 


[java]Track: "Motherless Child" (Martin L.Gore) 00: 03: 32 


BUILD 
Total 














SUCCESSFUL 
time: 2 seconds 





最 后 


容 的 碍 询 





， 图 5-3 显 示 了 在 HSQLDB 界 面 中 检索 ALBUM_TRACKS 表 内 


o 


600 


日 jdbe:hsqldb: data/music 
-E ALBUM 
schema: PUBLIC 
E ALBUM_ID 
TITLE 
-E NUMOGCS 
E ADDED 
f Indices 
-E ALBUM ARTISTS 
E ALBUM. COMMENTS 
HE ALBUM TRACKS 
schema: PUBLIC 
@ ALBUM_ID 
-E TRACKID 
- DEC 
国 POSITIONONDISC 
国 LIST_POS 
Indices 





HE TRACK COMMENTS 
A) Propertie 


图 5-3 内 容 经 过 扩充 后 的 关联 集合 


其 他 


删除 集合 元 素 、 重 新 排列 以 及 其 他 对 这 些 相 互 关 联 的 信息 的 处 理 ? 
这 些 处 理 都 是 自动 文 持 的 ， 下 一 节 将 会 演示 这 些 内 容 。 


关联 的 生命 周期 


Hibernate 完 全 负责 ALBUM_TRACKS 表 的 管理 ， 当 为 Album bean 的 
tracks 属 性 增加 或 删除 数据 项 时 ，Hibernate 会 自动 辐 ALBUM_TRACKS 
表 中 增加 或 删除 相应 的 记录 行 〈 必 要 时 会 重新 计算 LIST_POS 值 ) 。 可 
以 写 个 测试 程序 进行 测试 ， 从 我 们 的 测试 专辑 中 删除 第 2 个 曲目 ， 然 后 
看 看 结果 如 何 。 一 种 快速 而 简单 的 做 法 就 是 将 下 列 4 行 代码 《如 例 5-12 
所 示 ) 添加 到 例 5-8 中 己 有 的 tx.commit © 那 一 行 的 后 面 ， 然 后 执行 ant 


schema ctest attest db 命令 。 





例 5-12: 删除 专辑 的 第 2 个 曲目 





tx=session.beginTransaction () ; 
album.getTracks () .remove (1) ; 
session.update (album) ; 
tx.commit O) ; 








这 样 做 会 改变 ALBUM_TRACKS 表 中 的 内 容 ， 如 图 5-4 所 示 (和 图 
5-3 的 原始 内 容 相 比较 ) 。 第 2 条 记录 已 经 被 删除 〈 记 住 ，Java 列 表 元 素 
的 索引 值 是 从 0 开始 的 ) ， 而 LIST_POS 也 做 了 调整 以 保证 其 连续 性 ， 以 
便 与 列表 元 素 的 索引 可 以 相对 应 〈 调 用 tracks.get O 所 用 的 参数 值 ) 。 





eoo HSQL Database Manager — 
0 | select * from album_tracks 





B jdbc:hsaldb: data/music 
B ALBUM | 
国 ALBUM_ARTISTS Clear 
B ALBUM COMMENTS 
国 ALBUM TRACKS 


国 ARTIST ALBUM ID | TRACK ID |DISC |POSITIONONDISC |LIST_POS| 
TRACK 


国 TRACK_ARTISTS 
E TRACK COMMENTS 
国 Properties 


图 5-4 删除 专辑 的 第 2 个 曲目 后 的 专辑 曲目 关联 


之 所 以 这 样 ， 是 因为 Hibernate 明 白 这 个 列表 是 由 Album 表 的 记录 “ 拥 
有 ”的 ， 而 这 两 个 对 象 的 “生命 周期 ”(ifecycle) 彼此 紧密 相连 。 设 想 一 
下 ， 如 果 整 个 Album 表 的 内 容 都 被 删除 会 发 生 什么 事 : 
ALBUM_TRACKS 里 所 有 相关 联 的 记录 也 会 跟着 被 删除 〈 如 果 你 不 信 ， 
可 以 修改 测试 程序 来 试 试看 ) 。 这 么 一 想 ， 生 命 周 期 的 概念 就 变 得 更 为 
T o </p> 








ALBUM 表 和 TRACK 表 之 间 的 关系 就 不 同 了 。 曲 目 有 时 会 和 专辑 关 
联 ， 但 有 时 也 是 独立 的 。 从 列表 中 删除 一 个 曲目 ， 就 会 导致 清除 
ALBUM_TRACKS 表 中 相应 的 一 行 记录 ， 专 辑 和 曲目 之 间 的 关联 也 随 之 
消失 ， 但 并 不 会 删除 TRACK 表 中 的 记录 行 ， 所 以 这 么 做 也 不 会 删除 持 
久 化 Track 对 象 本 身 。 同 样 地 ， 删 除 Album 对 象 会 把 集合 中 所 有 的 关联 都 











清除 ， 但 所 有 实际 的 Track 对 象 都 不 受 影 响 。 我 们 的 代码 只 是 负责 在 适 
当 的 时 机 进行 这 些 操作 (或许 在 同 用 户 咨 询 以 后 ， 许 不 定 有 些 曲 目 记 录 











如 果 我 们 不 需要 在 专辑 之 间 共 享 相同 曲目 的 灵活 性 (对 于 压缩 的 音 
频 文件 的 体积 来 说 ， 其 占用 的 磁盘 空间 最 近 相 当 便 宜 ) ， 也 可 以 让 
Hibernate 以 管理 ALBUM_TRACKS 和 集合 的 相同 方式 来 管理 专辑 的 
TRACK 记录 。Hibernate 当 然 不 会 以 为 它 应 该 这 么 做 ， 因 为 Track 和 
Album 对 象 能 彼此 独立 存在 ， 但 是 我 们 可 以 在 专辑 映射 文档 中 为 二 者 之 
间 建 立 生 命 周期 关系 。 





注意 : 现在 ， 已 经 知道 有 可 以 自动 化 处 理 这 些 的 方式 ， 可 能 不 会 再 
感到 吃惊 了 吧 。 


应 该 怎么 做 


例 5-13 展 示 了 我 们 对 Album.hbm.xml 里 的 tracks 属 性 映射 做 出 的 修改 
(以 粗 体 表示 ) 。 


例 5-13: 为 专辑 和 它 的 曲目 建立 生命 周期 关系 





<list name="tracks"table="ALBUM TRACKS" cascade="411"—> 
<meta attribute="use-in-tostring">true</meta> 

<key column="ALBUM ID"/> 

<index column="LIST_ POS"/> 

<composite-element class="com.oreilly.hh.AlbumTrack"> 























<many-to-one class="com.oreilly.hh.Track"name="track" 
cascade="all"> 

<meta attribute="use-in-tostring">true</meta> 
<column name="TRACK_ID"/> 

</many-to-one> 

<property name="disc"type="integer"/> 

<property name="positionOnDisc"type="integer"/> 
</composite-element > 

</list> 

















cascade 属 性 用 于 告诉 Hibernate， 需 要 将 “ 父 ”(parent) 对 象 上 施加 
的 操作 也 应 用 到 它 的 “ 子 ”(child) kin” (dependent) 对 象 上 。 这 一 
属性 适用 于 所 有 形式 的 集合 和 关联 。 它 有 几 种 可 供 选择 的 预 设 值 ， 最 党 
见 的 是 none (默认 值 ) 、save-update、delete 以 及 all (组 合 了 save-update 
和 delete) 。 还 可 以 通过 在 hibernate-mapping 标 签 内 部 提供 一 个 default- 


cascade 属 性 ， 将 整个 映射 文档 范围 内 的 默认 值 从 none 变 为 save-update。 


就 此 例 而 言 ， 我 们 希望 专辑 所 包含 的 曲目 都 由 专辑 自动 管理 ， 这 
样 ， 当 删除 某 个 专辑 时 ， 它 的 曲目 也 会 随 之 删除 。 注 意 ， 我 们 必须 为 
tracks 集 合 和 组 成 它 的 track 元 又 都 应 用 cascade 属 性 ， 才 能 做 到 这 一 点 。 
此 外 ， 将 cascade 属 性 设置 为 al 时 ， 就 不 用 再 明确 保存 我 们 为 专辑 而 创建 
的 任何 Track 对 象 ， 也 就 是 例 5-8 中 的 addAlbumTrack() 方法 不 再 需要 
以 下 这 行 : 








session.save (track) ; 





通过 告诉 Hibernate 让 它 负 责 维 护 专辑 及 其 曲目 之 间 的 关联 关系 ， 就 
可 以 让 Hibernate 在 曲目 被 加 进 专 辑 时 上 自动 将 曲目 对 象 〈Track 对 象 ) 持 


入 保存 ， 同 时 在 删除 专辑 时 也 可 以 删除 相关 的 所 有 曲目 。 


Hibernate 对 生命 周期 关系 的 管理 并 不 是 十 分 安全 的 〈fool-proof) ， 
或 许 更 准确 地 说 ， 它 并 非 是 无 所 不 包 的 。 例 如 ， 如 果 使 用 Collections 接 
口 的 方法 从 Album 的 tracks 属 性 中 删除 一 个 Track 对 象 ， 这 样 会 打 断 
Album 和 Track 之 间 的 关联 ， 但 实际 上 并 不 会 删除 那个 Track 对 象 对 应 的 
记录 。 即 使 以 后 把 整个 Album 删 除 掉 ， 那 个 Track 还 会 保留 着 ， 因 为 删除 
Album 的 时 候 ， 原 来 被 删除 的 那个 Track 已 经 没有 和 被 删除 的 Album 之 间 
有 关联 了 。 适 当 修 改 AlbumTestjava 就 能 做 一 些 这 类 实验 ， 看 看 数据 表 
中 最 后 的 结果 ! 





事实 上 ， 在 某 些 特定 的 情况 下 ，Hibernate 可 以 负责 处 理 这 种 级 别 的 
细节 。 只 要 在 父子 关系 中 使 用 多 对 一 Cmany-to-one) 映射 ， 就 可 以 将 映 
射 的 cascade 属 性 标识 为 delete-orphan。 相 关 的 更 多 细节 可 以 查阅 
Hibernate 在 线 参 考 手册 的 “传播 性 持久 化 ”(Transitive persistence (H 


yD tae 


将 这 种 信息 登记 处 理 委托 给 映射 层 实在 方便 ， 这 样 你 就 能 把 精力 集 
中 在 更 为 抽象 和 重要 的 任务 上 ， 所 以 在 时 机 适当 时 值得 使 用 。 这 会 让 人 
想起 Java 那 令 人 信服 的 垃圾 收集 机 制 所 带 来 的 程序 员 的 解放 ， 但 是 也 有 
一 定 的 局 限 性 ， 例 如 ， 无 法 通过 可 达 性 分 析 (reachability analysis) 而 明 
确 地 知道 什么 时 候 已 经 完成 了 数据 的 持久 化 。 你 得 调用 delete () ， 并 
建立 生命 周期 连接 ， 才 可 以 在 代码 中 指明 这 一 点 。 灵 活性 和 自动 化 的 简 











单 性 之 间 的 得 失 是 由 你 决定 的 ， 取 决 于 数据 的 本 质 和 项 目的 需要 。 


[1] 
http:/ /www.hibernate.org/hib_docs/v3/reference/en/html/objectstate.html#o 


transitive. 


自身 关联 


对 象 和 数据 表 也 可 以 关联 到 它们 自身 ， 这 种 关联 叫做 自身 关联 
(reflexive association) 。 这 种 关联 用 于 支持 持久 化 递归 结构 的 数据 ， 
例如 树 状 结构 ， 这 种 结构 中 的 节点 之 间 会 彼此 互相 链接 。 数 据 库 表 中 如 
果 存 储 了 这 种 关系 的 数据 ， 要 以 SQL 查询 接口 来 检索 这 些 数 据 将 非常 困 
难 。 所 幸 ， 将 这 种 关联 映射 到 Java 对 象 后 ， 处 理 就 变 得 更 容易 理解 和 自 
IR T 








在 我 们 的 音乐 数据 库 中 可 能 使 用 目 身 链接 (reflexive link) 的 方式 
之 一 是 让 艺人 可 以 有 替换 姓名 〈alternate name) 。 这 一 功能 的 用 处 可 能 
会 超出 你 的 预期 ， 因 为 如 末 让 用 户 根据 他 们 的 思维 方式 来 决定 查找 "The 
Smiths" =k" Smiths, The"， 有 了 符 换 姓名 就 容易 多 了 ， 只 要 一 点 点 程序 代 
码 ， 而 且 实 现 方式 与 编程 语言 无 基 。 











注意 : 我 是 指 人 类 语言 ， 英 语 、 西 班 牙 语 或 其 他 语言 。 在 数据 中 放 
入 这 类 链接 ， 而 不 是 试图 去 编写 难以 理解 的 程序 代码 来 猜测 何 时 应 该 调 
换 艺 人 的 姓名 。 


应 该 怎么 做 


需要 做 的 事 就 是 在 ArtisLhbm.xml 里 为 Artist 映 射 新 增 另 一 个 字段 ， 


以 建立 一 个 指向 Artist 的 链接 。 例 5-14 演 示 了 一 种 配置 方法 。 





例 5-14: 在 Artist 类 中 建立 自身 关联 





<many-to-one 

name="actualArtist"class="com.oreilly.hh.data.Artist"> 
<meta attribute="use-in-tostring">true</meta> 
</many-to-one> 














这 个 示例 配置 了 一 个 actualArtist 属 性 ， 在 建立 一 个 艺人 的 替换 姓名 
时 ， 我 们 可 以 将 其 设置 为 “实质 的 ”Artist 记 录 的 id 值 。 例 如 ，"The 
Smiths" 记 录 的 id 值 可 能 是 5， 而 它 的 actualArtist 字 段 应 该 是 null， 因 为 这 
个 记录 是 实质 的 艺人 记录 。 人 然后， 我 们 随时 都 可 以 用 "Smiths, The" 这 样 
的 姓名 创建 “别名 ”Artist 记 录 ， 并 将 这 个 别名 记录 里 的 actualArtist 字 上 段 设 
置 为 5， 以 指向 实质 的 记录 。 





有 时 ， 作 为 外 键 的 字段 不 能 按照 其 链接 到 的 主键 字段 的 名 称 来 命 
名 ， 自 身 链 接 就 是 这 样 的 一 个 例子 。 我 们 将 ARTIST 表 中 的 一 行 数 据 关 
联 到 ARTIST 表 中 的 另 一 行 ， 当 然 ， 数 据 表 中 已 经 有 名 为 ARTIST ID 的 
字段 了 。 











为 什么 要 将 这 种 关联 设置 为 多 对 一 Cmany-to-one) 类 型 的 ? 也 许 会 
有 很 多 别名 记录 会 指 同 茶 个 特定 的 实质 Artist 记 录 。 所 以 ， 每 个 别名 记 
录 都 必须 保存 实际 艺人 记录 的 id， 才 能 视 其 为 痊 换 姓名 。 用 数据 建 模 语 
言 来 说 ， 这 就 是 一 种 多 对 一 关系 。 














碍 找 艺 人 的 代码 只 需要 在 返回 前 检查 actualArtist 属 性 。 如 果 是 
nul， 一 切 都 没有 问题 ， 否则， 就 应 该 返回 actualArtist 属 性 指向 的 记 
录 。 例 5-15 扩 展 了 CreateTest 中 的 getArtist () 方法 ， 以 支持 这 种 新 功能 
(新 增 处 以 粗 体 字 表示 ) 。 注 意 ，Artist 构 造 函 数 多 了 一 个 用 于 设置 
actualArtist 的 新 参数 ， 所 以 ， 即 使 我 们 不 用 显示 蔡 换 姓 名 ， 也 得 更 新 
CreateTest 中 其 他 调用 这 个 构造 函数 的 各 个 地 方 。 


例 5-15: 文 持 人 答 换 姓名 解析 的 艺人 碍 询 方法 








public static Artist getArtist (String name, boolean create, 
Session session) { 
Query 
query=session.getNamedQuery ("com.oreilly.hh.artistByName") ; 
query.setString ("name", name) ; 
Artist found= (Artist) query.uniqueResult () ; 
if (found==null& &create) { 
found=new Artist (name, new HashSet (), null); 
session.save (found) ; 












































if (found! =null&&found.getActualArtist () ! =null) { 
return found.getActualArtist () ; 

















return found; 





希望 这 一 章 能 让 你 感受 到 Hibernate 中 关联 和 集合 的 丰富 而 强大 的 功 
。 很 明显 ， 你 可 以 结合 这 些 功 能 ， 层 层 舱 套 ， 当 中 的 变化 之 多 ， 雹 怕 
我 们 难以 在 像 这 样 的 一 本 书 中 解释 清楚 。 


好 消 妃 是 Hibernate 似 乎 已 经 相当 完善 ， 足 以 应 付 实 际 应 用 中 可 能 会 
遇 到 的 各 种 关联 关系 ， 甚 至 为 你 完成 建立 数据 类 和 数据 库 模 式 ， 这 样 辛 








苦 繁 重 的 工作 。 当 我 开始 创建 这 些 示例 时 ，Hibernate 工 作 的 有 效 性 和 深 
远 性 远 远 超过 了 我 的 预期 。 


Rom Axe MRE 


用 户 目 定义 闫 型 


由 附录 A 可 见 ，Hibernate 文 持 很 多 Java 类 型 〈 既 有 简单 的 值 类 型 ， 
也 有 对 象 类 型 ) 。 通 过 建立 映射 规范 ， 甚 至 可 以 将 非常 复杂 的 、 藤 套 的 
对 象 结构 持久 化 保存 到 任何 数据 表 和 字段 内 。 既 然 Hibernate 提 供 的 功能 
强大 而 又 灵活 ， 你 可 能 会 问 为 什么 Hibernate 内 建 的 类 型 支持 还 会 不 够 
FA? 


促使 你 使 用 Hibernate 自 定义 类 型 的 一 种 情况 是 ， 你 想 使 用 不 同 于 
Hibernate 通 常情 况 下 会 选择 的 SQL 字段 类 型 来 保存 某 种 特定 的 Java 类 
型 。Hibernate 参 考 文档 引用 了 一 个 例子 ， 它 将 Java BigInteger 类 型 的 值 
持久 化 保存 到 VARCHAR 字 段 。 在 茶 些 为 了 兼容 于 传统 数据 库 (legacy 
database) 模式 的 情况 下 ， 就 可 能 需要 这 么 做 。 





男 一 种 常见 的 自 定义 类 型 使 用 场合 涉及 枚 举 类 型 值 的 持久 化 。 在 
Java 5 以 前 ， 没 有 为 枚 举 类 型 提供 内 建 的 语言 文 持 。 所 以 ， 尽 管 Joshua 
Bloch 在 他 的 《Effective Java Programming Language Guide) (Addison- 
Wesley) 一 书 中 提出 的 优秀 的 设计 模式 是 事实 上 的 标准 ， 但 Hibernate 还 
是 不 知 应 该 如 何 支 持 这 一 概念 。 在 Hibernate 3 之 前 ，Hibernate 就 提供 了 


PersistentEnum 接 口 ， 但 这 一 接口 与 Java 5 中 引入 的 原生 (native) 枚 举 
类 型 enum ) 的 支持 并 不 适合 ， 所 以 PersistentEnum 对 于 Java 5 的 enum 
类 型 也 没有 什么 用 途 。 而 有 旦 不幸 的 是 ，Hibernate 现 在 还 没有 提供 相应 的 
蔡 换 解决 办 法 ， 所 以 我 们 在 这 里 将 介绍 如 何 利用 Hibernate 对 自 定义 类 型 
的 支持 来 实现 枚 举 类 型 的 持久 化 。 


为 一 种 需要 调整 类 型 系统 的 场合 是 ， 你 必须 将 一 个 属性 值 拆 分 成 多 
个 组 成 分 部 ， 并 保存 到 多 个 数据 库 字 段 。 也 许 ， 公 司 内 部 强制 要 求 使 用 
的 可 重用 库 中 的 Address 对 象 是 把 ZIP+4 码 保存 成 了 一 个 单独 的 字符 串 ， 
但 是 你 要 整合 的 数据 库 却 需要 一 个 5 位 数字 的 字段 和 一 个 4 位 数字 、 其 值 
可 为 null 的 字段 ， 来 保存 这 两 部 分 的 数据 。 或 者 ， 也 有 可 能 是 相反 的 情 
况 ， 需 要 将 一 个 数据 库 字 段 拆 分 成 多 个 属性 。 


所 羊 ， 像 这 种 情况 ，Hibernate 可 以 让 你 控制 持久 化 映射 的 细节 ， 使 
你 在 不 得 已 时 也 能 找到 一 种 权宜 之 计 。 








注意 :让 简单 的 事情 更 容易 ， 复 杂 的 事情 有 可 能 。 这 样 的 精神 要 持 
续 下 去 。 








即使 在 某 些 不 是 严格 必需 的 情况 下 ， 你 也 可 能 会 想 建 并 自 定 义 值 类 
型 。 如 果 你 有 一 个 复合 类 型 (composite type) ， 它 在 整个 应 用 程序 中 的 
许多 地 方 都 用 得 到 向量、 复数 、 地 址 等 ) ， 你 当然 可 以 把 会 用 到 它 的 
地 方 都 映射 成 组 件 。 但 是 ， 将 映射 细节 封装 在 一 个 可 共享 的 、 可 重用 的 





Java 类 由， 比 让 映射 细节 在 每 个 映射 文档 内 到 处 传播 可 能 更 有 价值 。 如 
此 一 来 ， 如 果 映 射 细节 因 任 何 原 因 需 要 修改 时 ， 只 需要 修改 一 个 类 ， 而 
不 用 去 寻找 和 调整 众多 特定 组 件 的 映射 配置 。 





就 上 述 所 有 使 用 场合 而 言 ， 所 需要 做 的 任务 就 是 告诉 Hibernate 一 种 
新 方法 ， 让 它 知道 如 何 对 内 存 中 特定 类 型 的 值 及 其 数据 库 持久 化 保存 形 
式 做 相互 转化 。 


应 该 怎么 做 


Hibernate 能 让 你 在 需要 的 情况 下 自行 提供 映射 值 的 馆 辑 ， 办 法 承 是 
实现 以 下 两 个 接口 之 一 : org.hibernate.usertype.UserType 或 


org.hibernate.usertype.CompositeUserType。 


Hibernate 会 为 特定 类 型 的 值 创建 一 个 转化 器 〈translator) ， 而 并 非 
为 它 另 外 创建 一 种 知道 如 何 自行 持久 化 的 新 类 型 的 值 ， 了 解 这 一 点 很 重 
要 。 换 言 之 ， 以 ZIP 码 为 例 ， 不 是 由 ZIP 码 属性 本 身 去 实现 UserType 接 
口 ， 而 是 我 们 要 另外 新 建 一 个 实现 了 UserType 接 口 的 类 ， 然 后 在 映射 文 
档 中 将 这 个 类 指定 为 用 于 映射 ZIP 码 属性 的 Java 类 型 。 因 此 ， 我 认为 “ 自 


定义 类 型 ”这 个 术语 有 些 令 人 混淆 。 





我 们 来 看 一 个 具体 的 示例 。 如 前 所 述 ， 目 定义 类 型 的 一 个 闸 见 目标 
就 是 持久 化 枚 举 类 型 。 虽 然 Hibernate 本 身 没有 提供 对 枚 举 类 型 的 支持 ， 


但 是 利用 UserType 机 制 可 以 容易 地 达到 这 一 目的 。 之 后 ， 我 们 还 会 介绍 
一 个 更 复杂 的 映射 例子 ， 它 涉及 多 个 属性 和 字段 之 间 的 映射 。 





定义 一 个 持久 化 的 枚 举 类 型 


枚 举 类 型 ‘enumerated type) 是 程序 设计 当中 常见 而 且 有 用 的 抽 
象 ， 可 以 让 你 从 一 组 固定 的 命名 选项 中 选取 其 值 。 枚 举 类 型 最 初 在 
Pascal 中 的 表达 形式 相当 不 错 ， 但 C 语 言 只 实现 了 最 基本 的 枚 举 类 型 
《基本 上 只 能 把 符号 名 称 指定 给 某 些 可 交换 的 整数 值 ) ， 结 果 早 期 的 
Java 版 本 只 保留 了 C 语 言 的 enum 关 键 字 ， 却 一 直 没 有 实现 它 。 一 种 名 
为 “类 型 安全 的 枚 举 模式 ”(typesafe enum pattern) 的 面向 对 象 的 优秀 方 
法 逐步 形成 ， 并 通过 Joshua Bloch 写 的 《Effective Java》 一 书 而 大 受 欢 
迎 。 这 种 枚 举 模式 方法 需要 编写 一 大 堆 模 板式 的 代码 ， 但 能 够 让 你 做 各 
种 有 趣 而 且 功 能 强大 的 事情 。 而 Java 5 规范 带 来 的 众多 令 人 振奋 的 创新 
之 一 就 是 让 enum 关 键 字 再 度 复活 ， 这 是 一 种 获得 类 型 安全 的 枚 举 功能 
的 简单 方法 ， 并 且 不 需要 编写 繁琐 的 模板 代码 。 此 外 ， 还 提供 了 其 他 好 
外 


























VER: C 语 言 风 格 的 数字 型 的 枚 举 类 型 还 是 在 Java 中 时 篆 出 现 。Sun 
API 中 有 旧 的 部 分 就 有 很 多 。 





不 论 枚 举 类 型 是 用 什么 方法 实现 的 ， 偶 尔 会 需要 将 这 种 值 持久 化 保 
存 到 数据 库 。 虽 然 现 在 Java 中 已 经 有 了 标准 的 枚 举 类 型 ， 但 Hibernate 并 
没有 提供 内 建 的 支持 。 所 以 我 们 来 看 看 如 何 用 Hibernate 的 UserType 接 口 


来 实现 枚 举 值 的 持久 化 。 


假设 我 们 想 要 能 够 指明 曲目 来 自 何 处 ， 例 如 录音 珊 、Vinyl、VHS 
影 带 、CD、 广 播 、Internet 下 载 网 站 以 及 数字 音频 流 。〔 我 们 需要 区 分 
从 Internet 网 站 下 载 ， 还 是 从 像 Sirius 或 XM 这 类 卫星 无 线 电 服务 下 载 ， 或 
者 区 分 是 从 无 线 电 台 还 是 从 电视 台 下 载 。 这 实在 会 让 人 发 疯 ， 不 过 ， 用 
来 说 明 这 个 重要 概念 倒是 很 适合 的 。 


不 考虑 持久 化 ， 类 型 安全 的 枚 举 类 看 起 来 可 能 类 似 于 例 6-1 (已 经 
对 JavaDoc 进 行 了 压缩 ， 以 节约 印刷 空间 。 但 是 ， 如 果 从 网 站 下 载 的 
话 ， 格 式 是 完整 的 ) 。 


例 6-1: SourceMedia.java《〈 第 一 个 类 型 安全 的 枚 举 类 ) 

















package com.oreilly.hh; 

/** 

*This is a typesaf numeration that identifies the media on which 
an 

*item in our music database was obtained. 

*/ 


public enum SourceMedia{ 

/**Music obtained from magnetic cassette tape.*/ 
CASSETTE ("Audio Cassette Tape") ， 

/**Music obtained from a vinyl record.*/ 

VINYL ("Vinyl Record") , 
/**Music obtained from VHS tapes.*/ 

VHS ("VHS Videocassette tape") ; 

/**Music obtained from a broadcast.*/ 

BROADCAST ("Analog Broadcast") , 

/**Music obtained from a digital compact disc.*/ 
CD ("Compact Disc"), 

/**Music obtained as an Internet download. */ 
DOWNLOAD ("Internet Download"), 

/**Music obtained from a digital audio stream. */ 





















































STREAM ("Digital Audio Stream") ; 

/** 

*Stores the human-readable description of this instance, by which 
it is 









































*identified in the user interface. 
* 

private final String description; 
/** 


*Enum constructors are always private since they can only be 
accessed 
*through the enumeration mechanism. 

















*@param description human readable description of the source for 
the 








*audio, by which it is presented in the user interface. 

Ai 

private SourceMedia (String description) { 
this.description=description; 

} 

/** 

*Return the description associated with this enumeration instance. 
* 





*@return the human-readable description by which this value is 
*identified in the user interface. 

xx / 

public String getDescription () { 

return description; 

} 

} 














“PR, (EH Hibernate @ Wh it ze BN A is BE OU Fs Java, wt 
可 以 增加 持久 化 支持 。 即 使 我 们 原来 在 设计 这 一 enum 类 型 时 还 没有 考 
虚 持 久 化 ， 我 们 以 后 也 是 照 原样 使 用 这 个 类 型 。 由 于 现在 不 必 考 虑 使 用 
过 时 的 PersistentEnum 接 口 ， 那 么 定义 一 个 可 持久 化 的 枚 举 类 型 与 定义 
其 他 任意 枚 举 类 型 束 没 有 什么 区 别 了 。 





注意 : 使 用 PersistentEnum 接 口 需 要 修改 欲 持 久 化 的 枚 举 类 型 的 定 
义 。 与 PersistentEnum 接 口 不 符合 《Effective Java》 提 出 的 可 持久 化 枚 举 


模式 或 Java 5 enum 关 键 字 相 比 ， 这 可 能 是 废除 PersistentEnum 接 口 的 更 
大 原因 。 


那么 如 何 告 诉 Hibernate 持 入 化 保存 我 们 的 枚 举 类 型 的 值 呢 ? 接 下 来 


就 介绍 这 些 。 


使 用 目 定 义 的 类 型 映射 


如 本 章 介 绍 部 分 所 述 ， 我 们 打算 创建 一 个 枚 举 类 ， 而 且 可 以 用 
Hibernate 对 它 的 值 进行 持久 化 。 我 们 将 这 个 新 类 命名 为 
SourceMediaType。 接 下 来 再 决定 它 需 要 实现 UserType 接 口 ， 还 是 
CompositeUserType 接 口 。Hibernate 参 考 文档 对 此 问题 没有 提供 什么 指 
导 ， 但 API 文 档 对 这 两 个 接口 名 称 所 隐 含 的 意义 做 了 确认 : 只 有 在 自 定 

类 的 实现 想 以 命名 属性 的 形式 来 暴露 其 内 部 结构 ， 使 其 能 在 查询 中 被 
单独 访问 时 《例如 ZIP 码 的 例子 ) ， 才 需要 使 用 CompositeUserType 接 
口 。 对 于 SourceMedia， 实 现 简单 的 UserType 就 够 用 了 。 例 6-2 演 示 了 符 
合 我 们 需要 的 映射 管理 器 (1) (mapping manager) 的 源 代 码 。 





例 6-2: 目 定 义 类 型 映射 处 理 器 〈SourceMediaType.javay) 





package com.oreilly.hh; 
import java.io.Serializable; 








import java.sql.PreparedStatement; 
import java.sql.ResultSet; 
import java.sgql.SQLException; 





























import java.sgql.Types; 




















import org.hibernate.Hibernate; 

import org.hibernate.HibernateException; 

import org.hibernate.usertype.UserType; 

/** 

*Manages persistence for the{@link SourceMedia}typesafe 











enumeration. 
xy 
public class SourceMediaType implements UserType{ 
/** 


*Indicates whether objects managed by this type are mutable. 





大 





*@return<code>false</code>, since enumeration instances are 


immutable 


*singletons. 


*/ 


public boolean isMutable () { 
return false; 





} 
/** 








*Return a deep copy of the persistent state, stopping at 
*entities and collections. 





* 


*@param value the object whose state is to be copied. 
*@return the same object, since enumeration instances are 


Singletons. 


i, 








public Object deepCopy (Object value) { 
return value; 


} 
/** 











*Compare two instances of the class mapped by this type for 


persistence 


*"equality". 


* 


@param x 





* first object to be compared. 
*@param y second object to be compared. 
*@return<code>true</code>iff both represent the same 














SourceMedia type. 


xy 





singletons 








*@throws ClassCastException if x or y isn't a{@link SourceMedia}. 








public boolean equals (Object x, Object y) { 
//We can compare instances, since SourceMedia are immutable 


return (x==y) ; 


} 
/** 





*Determin 
* 





the class that is returned by{@link#nullSafeGet}. 


*@return{@link SourceMedia}, the actual type returned 
*by{@link#nullSafeGet}. 


EJ 





public Class returnedClass () { 





return SourceMedia.class; 


} 
/** 


*Determin 


the SQL type (s) of the column (s) used by this type 








mapping. 


* 


*@return a single VARCHAR column. 


E 


public int[]sqlTypes O 10 
//Allocate a new array each time to protect against callers 


changing 





//its contents. 
int[]typeList=new int[1]; 
typeList [0]=Types.VARCHAR; 
return typeList; 

















} 
/** 


ResultSet}. 


* 


retrieved. 
*@param names 
retrieved. 
*@param owner 





</code>. 








database. 
ay 
public Object 
owner) 





*@param rs the results 


*@return the retrieved{@link SourceMedia}value, 


*@throws SQLException i 











*Retrieve an instance of the mapped class from a JD 











the entity containing the value being 














BC{@link 


from which the instance should be 


the columns from which the instance should be 


retrieved. 


or<code>null 


f there is a problem accessing the 


nullSafeGet (ResultSet rs, String[]names, Object 


throws SQLException@ 





{ 


//Start by looking up the value name 
String name= (String) Hibernate.STRING.nullSafeGet (rs, 


names [0]) ; 





return null; 


} 














if (name==null) { 


//Then find the corresponding enumeration value 


tryt 





return SourceMedia.valueOf (name) ; @ 


} 











catch (IllegalArgumentException e) { 


throw new HibernateException ("Bad SourceMedia valu 


} 
} 
/** 














*Write an instance of the mapped class to a{@link 
PreparedStatement}, 
*handling null values. 


K 


"+name, 


) ; 





*@param st a JDBC prepared statement. 
*@param value the SourceMedia value to write. 
*@param index the parameter index within the prepared statement at 


which 
* 











this value is to be written. 

*@throws SQLException if there is a problem accessing the 
database. 

xJ 

public void nullSafeSet (PreparedStatement st, Object value, int 
index) 

throws SQLException® 

{ 
String name=null; 

if (value! =null) 

name= ( (SourceMedia) value) .toString ©) ; 

Hibernate.STRING.nullSafeSet (st, name, index) ; 

} 

/** 

*Reconstruct an object from the cacheable representation.At the 
very least this 

*method should perform a deep copy if the type is mutable. 


(optional operation) 
* 
























































*@param cached the object to be cached 

*@param owner the owner of the cached object 

*@return a reconstructed object from the cachable representation 

EY 

public Object assemble (Serializable cached, Object owner) { 

return cached; 

} 

/** 

*Transform the object into its cacheable representation.At the 
very least this 

*method should perform a deep copy if the type is mutable.That may 
not be enough 
*for some implementations, however; for example, associations must 
be cached as 


*identifier values. (optional operation) 
* 









































*@param value the object to be cached 

*@return a cachable representation of the object 
are 
public Serializable disassemble (Object value) { 
return (Serializable) value; 

} 

/** 


*Get a hashcode for an instance, consistent with 

















persistence"equality". 

*@param x the instance whose hashcode is desired. 

xy 

public int hashCode (Object x) { 

return x.hashCode () ; 

} 

/** 

*During merge, replace th xisting (target) value in the entity 
we are merging to 

*with a new (original) value from the detached entity we are 
merging.For immutable 

*objects, or null values, it is safe to simply return the first 
parameter.For 

*mutable objects, it is safe to return a copy of the first 
parameter.For objects 

*with component values, it might make sense to recursively replace 


component values. 
大 

































































*@param original the value from the detached entity being merged 

*@param target the value in the managed entity 

*@return the value to be merged 

Ay 

public Object replace (Object original, Object target, Object 
owner) 

throws HibernateException 

{ 

return original; 

} 

} 


























这 么 长 的 一 大 段 代 码 看 起 来 有 些 令 人 晨 惧 ， 不 过 ， 不 要 担心 。 这 个 
类 中 的 所 有 方法 都 是 由 UserType 接 口 指定 的 。 我 们 的 实现 相当 简洁 明 
了 ， 刚 好 符合 我 们 万 做 的 简单 映射 的 需要 。 前 三 个 方法 没什么 可 讨论 
的 ， 看 看 JavaDoc 和 代码 内 贬 的 注释 就 够 了， 以 下 是 对 代码 中 一 些 有 意 
思 的 地 方 进行 的 注释 : 





@sqlTypes() 方法 向 Hibemate 报 告 该 自 定义 类 型 需要 保存 其 值 的 
列 的 数量 ， 以 及 这 些 列 的 SQL 类 型 。 这 里 我 们 的 类 型 使 用 一 个 


VARCHAR 类 型 的 列 。 


因为 API 规 定 必 须 将 这 种 信息 作为 数组 返回 ， 安 全 的 编码 实践 要 求 
在 每 次 调用 时 都 创建 和 返回 一 个 新 的 数组 ， 以 防止 恶意 代码 或 错误 代码 
可 能 操纵 该 数组 的 内 容 《〈Java 不 文 持 不 可 变数 组 。 如 果 UserType 接 口 声 
明 这 个 方法 返回 Collection 或 List 就 好 了 ， 因 为 这 些 类 型 可 以 是 不 可 变 
的 ) 。 








@OfEnullSateGet O 中 ， 我 们 将 数据 结果 转换 为 相应 的 MediaSource 
枚 举 值 。 因 为 我 们 知道 这 个 值 在 数据 库 中 保存 为 字符 串 ， 所 以 能 够 将 实 
际 的 碍 询 过 程 委托 给 Hibernate 的 工具 方法 ， 让 它 从 数据 库 结果 中 加 载 字 
符 串 。 在 大 多 数 情况 下 ， 都 能 够 做 这 样 的 处 理 。 











全 接着 只 需要 使 用 枚 举 类 型 自己 的 实例 查询 功能 。 


@HibernateException 是 当 执 行 映射 操作 发 生 问 题 时 ，Hibernate 抛 出 
的 一 个 Runtime-Exception。 我 们 这 里 “借用 ”了 现成 的 Hibermate 异 常 ， 
为 可 以 认为 问题 与 映射 相关 。 如 果 我 们 想 搞 得 花哨 些 ， 可 以 通过 定义 自 
己 的 异常 类 型 来 提供 更 多 的 细 市 ， 不 过 最 好 让 自 定义 的 异常 类 扩展 
HibernateException， 尤 其 是 在 像 Spring 这 样 的 抽象 框架 中 使 用 时 ， 这 样 
做 更 有 意义 《我 们 将 在 第 13 章 介绍 Spring) 。 


合 另 一 个 方向 的 映射 是 由 nullSafeSet O 处 理 的 。 我 们 再 一 次 依靠 
Java 与 内 建 的 enum 机 制 将 SourceMedia 实 例 转换 为 相应 的 名 称 ， 接 着 使 





用 Hibernate 工 具 将 这 个 字符 串 保 存 到 数据 库 中 。 





在 所 有 对 值 进行 处 理 的 方法 中 ， 很 重要 的 一 点 就 是 编写 代码 的 方 
法 ， 如 果 任 何 一 个 参数 为 null 时 (这 种 情况 经 常 发 生 ) ， 方 法 执行 不 会 
骨 演 。 方 法 名 称 前 的 "nullSafe" 前 级 就 是 对 此 的 一 种 提醒 ， 不 过 ， 即 使 是 
equals O 方法 也 必须 谨慎 使 用 。 盲 目地 使 用 x.equals (y) ， 当 x 为 null 
时 ， 就 会 让 程序 崩溃 。 





其 他 方法 是 一 些 普 通 的 接口 方法 的 实现 ， 因 为 在 处 理 不 可 变 的 单 例 
x} (immutable singleton) 时 ， 虽 然 是 枚 举 值 ， 也 应 该 避免 在 持久 化 管 
理 时 潜在 的 复杂 性 。 


好 吧 ， 我 们 已 经 创建 了 一 个 目 定 义 的 类 型 持久 化 处 理 器 ， 它 并 没有 
想象 中 的 那么 难 。 接 下 来 就 可 以 真正 用 它 来 持久 化 我 们 的 枚 举 数据 了 。 


应 该 怎么 做 


IKEAS AE. ÆA TEX, SourceMedia, FAME 
理 占 和 SourceMediaType 以 后 ， 需 要 做 的 就 是 修改 以 前 的 映射 文档 ， 在 
需要 映射 的 地 方 ， 使 用 我 们 自 定义 的 持久 化 管理 器 类 而 不 是 原先 的 原始 


值 类 型 Craw value type) 。 





我 们 将 通过 一 个 例子 ， 用 媒体 来 源 枚 举 类 型 来 演示 它 的 持久 化 。 但 


征 在 深入 这 个 例子 以 前 ， 我 们 先 稍 候 片 刻 ， 考 碟 一 下 如 何 让 实现 变 得 更 
加 通用 ， 以 便 在 更 大 的 项 目 中 使 用 。 


其 他 


如 果 需 要 持久 化 保存 多 个 枚 举 类 型 呢 ? 如 果 你 曾经 考虑 过 这 个 问 
题 ， 你 可 能 会 认为 这 与 例 6-2 在 本 质 上 没有 什么 不 同 ， 只 不 过 例 6-2 只 专 
注 于 持久 化 我 们 的 SourceMedia 枚 举 类 型 。 代 码 中 涉及 类 型 的 位 置 只 有 
几 处 (如 果 和 忽略 JavaDoc， 甚 至 要 更 少 )。 为 什么 不 能 将 枚 举 类 型 参数 
化 ， 在 一 个 单独 的 实现 中 就 可 以 支持 任何 枚 举 类 型 ， 这 样 做 不 是 更 简单 
吗 ? 


确实 ， 这 样 做 会 相当 简单 ， 如 果 Hibernate 要 是 内 建 了 一 种 这 样 简单 
而 灵活 的 机 制 ， 那 就 更 好 了 。 在 Hibernate 维 基 (wiki) 上 还 有 几 种 可 供 
选择 的 方法 〈 在 几 个 不 同 的 页 面 上 ， 可 能 需要 按 主题 类 型 浏览 ) ， 或 许 
我 们 应 该 采用 Gavin King 提 出 的 Enhanced UserType 〈 改 进 版 的 
UserType) (在 Java5 EnumUserType (°!) 主题 页 ) ， 来 作为 我 们 非 
官方 的 “官方 选择 ”(afficial choice) ， 因 为 他 是 Hibernate 诸 多 作者 之 
一 。 这 种 方法 的 功能 看 起 来 已 经 相当 完整 了 ， 只 是 还 没有 轻率 地 付 诸 实 
用 。 不 过 ， 现 在 至 少 可 以 考虑 一 下 将 它 与 例 6-2 进 行 比较 ， 看 看 在 让 我 
们 的 解决 方案 更 为 通用 化 方面 还 能 做 哪些 工作 。 














注意 ;我 可 以 听 到 很 多 感慨 “到 时 间 了 >”! 


但 是 现在 ， 继 续 我 们 具体 的 示例 ， 看 看 怎么 样 真正 使 用 我 们 的 枚 举 


类 型 ! 


四 这里， 原文 中 使 用 了 映射 管理 器 (mapping manager) 以 及 自 定 义 类 型 
映射 处 理 器 (custom type mapping handler) 这 两 个 不 同 的 词 ， 容 易 让 读 
者 产生 混淆 。 事 实 上 ， 它 们 都 是 指 同样 的 概念 。 

[2] http://www.hibernate.org/272.html. 


使 用 持久 化 的 枚 举 对 象 





你 可 能 已 经 注意 到 ， 本 章 一 开始 并 没有 为 SourceMedia 类 定义 持久 
化 映射 。 这 是 因为 枚 举 类 型 是 一 个 值 ， 只 能 将 它 作 为 一 个 或 多 个 实体 的 
一 部 分 而 进行 持久 化 保存 ， 而 不 是 目 成 一 个 实体 。 





因此 ， 我 们 还 没有 做 任何 映射 也 就 不 奇怪 了 。 当 我 们 要 实际 使 用 持 
入 化 的 枚 举 类 型 时 ， 才 需要 这 么 做 ， 这 就 是 本 节 要 介绍 的 内 容 。 


应 该 怎么 做 


回想 一 下 ， 我 们 想 在 自动 唱片 机 系统 中 保存 音乐 曲目 的 来 源 媒介 。 
也 就 是 说 ， 我 们 想 在 Track 映射 配置 中 使 用 SourceMedia 这 一 枚 举 类 型 。 
可 以 简单 地 在 Track.hbm.xml 中 的 class 定 义 内 添加 一 个 新 的 property 标 
签 ， 如 例 6-3 所 示 。 


例 6-3: 在 Track 映射 文档 中 新 增 一 个 SourceMedia 属 性 





<property name="volume"type="sShort"> 

<meta attribute="field-description" >How loud to play the track 
</meta> 

</property> 

<property 
name="sourceMedia"type="com.oreilly.hh.SourceMediaType"> 

<meta attribute="field-description" >Media on which track was 
obtained</meta> 


























<meta attribute="use-in-tostring">true</meta> 
</property> 
<set name="comments"table="TRACK COMMENTS" > 

















注意 ， 我 们 告诉 Hibernate， 这 个 属性 是 UserType 接 口 的 实现 类 ， 而 
不 是 它 负 责 持久 化 的 原始 枚 举 类 型 。 因 为 sourceMedia 属 性 的 type 配 置 了 
一 个 实现 了 UserType 接 口 的 实现 类 ，Hibernate 束 会 委托 这 个 类 来 为 
sourceMedia 属 性 执行 持久 化 ， 以 及 查找 与 映射 相关 的 Java 类 和 SQL 类 
型 。 








现在 ， 运 行 ant codegen 命 令 来 更 新 Track 类 ， 以 引入 这 个 新 的 属性 。 


不 要 这 么 快 


在 开发 本 章 示 例 期 间 ， 我 遇 到 过 一 个 奇怪 的 问题 ， 代 码 突然 不 能 通 
过 编译 ， 报 告 没 有 发 现 构 造 函 数 。 起 初 ， 这 个 问题 看 起 来 好 像 和 采用 
Maven Ant Tasks 进 行 依 赖 管理 有 关 ， 这 个 问题 在 我 测试 时 第 一 次 出 现 。 
仔细 检查 源 代 码 ， 确 定 是 不 是 哪 出 问题 了 。 这 花费 了 不 少时 间 ， 因 为 这 
段 代 码 很 微妙 。 可 能 是 因为 Track 类 的 sourceMedia 属 性 被 赋予 了 
SourceMediaType 类 型 的 值 《映射 管 理 右 ) ， 而 不 是 它 应 该 接受 的 


SourceMedia 类 型 。 


在 所 有 办 法 都 失败 以 后 ， 我 将 这 个 麻烦 的 bug 报 告 给 了 Hibernate 
Tools 团 队 ， 他 们 很 快 回复 说 不 能 重 现 那 个 问题 ， 这 时 我 明日 是 怎么 回 





事 了 。 构 建 过 程 之 所 以 中 断 是 因为 : Hibernate Tools 需 要 能 够 找到 编译 
好 的 SourceMediaType 类 ， 了 映射 文档 才 有 意义 ， 也 才能 够 知道 这 个 类 是 
用 户 目 定义 的 类 型 。 在 写 这 上 段 文字 时 ， 我 已 经 编写 和 编译 好 了 
SourceMediaType 类 ， 这 样 ， 当 我 按 例 6-3 所 示 来 更 新 映射 配置 并 调用 
codegen 构 建 目标 时 ， 该 类 编译 好 的 类 文件 应 该 到 位 了 。 但 当 我 回头 再 
用 Maven Ant Tasks 进 行 测 试 时 ， 其 实 这 时 还 没有 编译 好 的 类 存在 ， 束 像 
你 在 下 载 代码 示例 文件 以 后 ， 再 控 本 书 半 市 介绍 的 办 法 来 更 新 创建 得 
询 测 试 。 不 过 ， 如 果 在 这 种 情况 下 ， 在 compile 之 前 运行 codegen 束 会 让 
你 处 于 一 种 类 文件 不 一 致 、 不 能 编译 的 境地 。 但 是 也 不 能 在 codegen 之 
前 运行 compile， 因 为 测试 类 的 运行 要 依赖 于 生成 的 数据 类 。 








注意 : 听 起 来 确实 有 些 像 经 典 的 catch-22 问 题 (因为 不 合 逻 辑 的 规 
定 而 造成 左右 为 难 的 困境 ) 。 


很 不 幸 ， 当 没有 很 谨慎 地 维护 构建 指令 时 ， 这 种 令 人 头痛 的 循环 依 
赖 问 题 并 非 不 常见 。 我 为 codegen 引 入 了 一 个 新 的 依赖 ， 但 没有 在 
build.xml 中 定义 。 因 为 我 们 但 找 错误 的 方 同 有 误 ， 所 以 浪费 了 很 多 时 
间 ， 但 也 正 因为 这 样 ， 我 才 有 机 会 描述 这 一 问题 和 它 的 解决 方案 。 所 
以 ， 和 希望 当 你 再 遇 到 类 似 的 情况 时 ， 会 变 得 更 聪明 些 。 





在 清楚 地 理解 了 问题 出 在 哪 以 后 ， 束 不 难 解 雇 了 。 例 6-4 展 示 了 需 
要 对 build.xml 做 的 修改 。 





例 6-4: 在 构建 过 程 中 定义 UserType 类 的 依赖 








<! --Compile the UserType definitions so they can be used in the 
code 

generation phase.--> 

<target name="usertypes"depends="pr pare"@ 

description="Compile custom type definitions needed in by 
codegen" > 

<javac srcdir="S{source.root}" 

includes="com/oreilly/hh/*Type.java" 

destdir="${class.root}" 

debug="on" 

optimize="off" 

deprecation="on"> 

<classpath refid="project.class.path"/> 

</javac> 

</target> 

<! --Generate the java code for all mapping files in our source 
tree--> 

<target name="codegen"depends="us rtypes"@ 

description="Generate Java source from the O/R mapping files"> 





















































@ 我 们 在 现 有 的 codegen 目 标 之 前 ， 创 建 了 一 个 名 为 usertypes 的 构建 
目标 ， 用 于 编译 刚才 的 用 户 类 型 定义 。 因 为 自 定义 类 型 不 会 引用 任何 生 
成 的 类 ， 所 以 可 以 在 codegen 目 标 运 行 之 前 移 编译 它们 。 选 择 这 些 自 定 
义 类 型 的 最 简单 的 方法 ， 就 是 利用 它们 位 于 com.oreilly.hh 包 这 一 事实 ， 
以 及 我 们 在 这 里 使 用 的 命名 惯例 (Hibernate 本 身 也 将 这 个 包 作 为 它 保存 
类 型 映射 类 的 地 方 )， 在 这 个 包 中 它们 的 类 文件 都 以 "Type.java" 结 
(例如 ，SourceMediaType.java， 以 及 本 章 稍 后 介绍 的 














StereoVolumeType.java) 。 


如 果 你 不 喜欢 这 样 的 惯例 ， 则 可 以 把 所 有 文件 都 列 在 这 里 ， 或 是 将 


它们 放 在 其 他 单独 的 包 中 。 这 种 命名 方法 碰巧 很 适合 我 们 的 需要 。 

@ 接 着 ， 我 们 更 新 codegen 构 建 目标 ， 让 它 依 赖 usertypes。 这 样 可 以 
保证 代码 生成 任务 运行 以 前 ， 它 需要 的 自 定 义 类 型 映射 总 能 成 功 编译 和 
使 用 (这 里 不 需要 依赖 prepare， 因 为 现在 只 需要 依赖 usertypes) 。 





配置 好 这 些 额 外 的 设置 以 后 ， 现 在 运行 ant codegen 就 可 以 正确 地 更 
新 Track 类 ， 以 包括 新 的 属性 。 完 整 的 Track 构造 函数 现在 应 该 如 下 所 


ZN: 








public Track (String title, String filePath, Date playTime, 
Set<Artist>artists, Date added, short volume, 
SourceMedia sourceMedia, Set<String>comments) {......} 








还 需要 相应 地 修改 CreateTest.javal 





Track track=new Track ("Russian Trance", 
"vyol2/album610/track02.mp3", 

Time.valueOf ("00: 03: 30") , 

new HashSet<Artist> O), 

new Date (), (short) 0, SourceMedia.CD, 

new HashSet<String> O ) ; 

track=new Track ("Video Killed the Radio Star", 
"vyol2/album611/track12.mp3"; 

Time.valueOf ("00: 03: 49") , new HashSet<Artist> O, 
new Date () , (short) 0, SourceMedia.VHS, 

new HashSet<String> © ); 
































为 了 得 到 如 图 6-1 所 示 的 结果 ， 我 们 将 "The World' 99" tid AK AF 
数字 音频 流 ， 而 将 其 他 曲目 都 标记 为 来 自 人 CD， 而 为 "Test Tone 1" 标 记 为 


空 的 (null) sourceMedia 值 。 这 时 ， 再 运行 ant schema 以 重建 支持 新 属性 
的 数据 库 模 式 ， 接 着 运行 ant ctest 以 创建 样 例 数据 。 


BHT IPA St 





我 们 的 TRACK 表现 在 包含 了 一 个 用 于 保存 sourceMedia 属 性 的 新 字 
段 。 在 创建 好 样 例 数据 后 就 可 以 在 这 个 表 的 内 容 中 看 到 它 的 值 ( 最 简单 
的 方法 就 是 用 ant db 命令 来 执行 查询 ， 结 果 如 图 6-1 所 示 )。 


are HSQL Database Manager 
| A jdbe:hsqidb:dara/music | —_— | ii 
f ARTIST 

B TRACK. 
Schema: PUBLIC 
B TRACKID — 

© TITLE TRACK_ID| TITLE 
国 FILEPATH Russian Trance 


E PLAYTIME 
E ADDED : Video Killed the Radio Star 


国 WOLUME Gravity's Angel 
E SOURCEMEDIA Adagio for Strings (Ferry Corsten Remix) CD 
© indices Adagio for Sirings (ATE Remix) 
 TRACK_ARTITS The World ‘99 
E TRACK. COMMENTS Test Tone 1 
f Properties += 











图 6-1 TRACK 表 中 的 来 源 媒介 信息 


通过 交叉 检查 为 我 们 的 持久 化 枚 举 类 型 赋值 的 代码 ， 可 以 验证 持久 
化 保存 到 数据 库 的 值 是 否 正 确 。 利 用 Java 5 的 enum 功 能 ， 甚 至 可 以 让 这 
种 原始 的 查询 显得 更 有 意义 。 














为 什么 不 能 工作 





在 为 我 们 的 映射 文档 引入 这 些 目 定义 类 型 的 同时 ， 也 就 在 build.xml 
引入 了 男 一 种 还 没有 反映 出 来 过 的 新 依赖 。 所 以 ， 如 果 一 不 小 心 ， 就 会 
在 运行 ant shema 命 令 之 前 ， 遇 到 ant 编 译 失 败 的 错误 ， 收 到 一 些 Hibernate 
报告 的 以 下 信息 : 














[hibernatetool] INFO: Using dialect: 
org. hibernate.dialect.HSQLDialect 
[hibernatetool]An exception occurred while running exporter#2: 
hbm2dd1 
(Generates database schema) 
[hibernatetool]To get the full stack trace run ant with-verbose 
[hibernatetool]org.hibernate.MappingException: Could not determine 
type 
for: com.oreilly.hh.StereoVolumeType, for columns: 
[org.hibernate.mapping 
.Column (VOL_LEFT) , org.hibernate.mapping.Column (VOL RIGHT) ] 
BUILD FAILED 
/Users/jim/Documents/Work/OReilly/svn_ hibernate/current/examples/c 
.xml: 81: org.hibernate.MappingException: Could not determine type 
for: com 
.oreilly.hh.StereoVolumeType, for columns: 
[org.hibernate.mapping.Column 
(VOL LEFT) , org.hibernate.mapping.Column (VOL RIGHT) ] 
Total time: 3 seconds 

























































































这 是 因为 ， 还 没有 编译 我 们 新 的 自 定义 类 型 ，Hibernate 不 能 发 现 或 
使 用 它们 ， 所 以 映射 起 不 到 作用 。 作 为 一 种 快速 修复 措施 ， 只 要 先 运行 
ant compile， 再 试 着 运行 ant schema 就 可 以 了 。 也 可 以 在 build.xml 中 修复 
这 个 问题 ， 这 样 以 后 就 不 会 再 麻烦 任何 人 了 : 











<! --Generate the schemas for all mapping files in our class 








tree--> 
<target name="schema"depends="compile" 
description="Generate DB schema from the O/R mapping files"> 














compile 构 建 目标 出 现在 schema 后 面 也 没有 什么 关系 ，Ant 会 安排 好 
它们 之 间 的 依赖 天 系 。 如 果 你 觉得 不 习惯 ,可 以 任意 交换 它们 的 位 置 。 
为 了 稳妥 起 见 ， 我 们 也 可 以 让 compile 依 赖 于 codegen， 以 确保 在 试图 编 
译 什么 以 前 ， 先 生成 数据 类 : 











<! --Compile the java source of the project--> 
<target name="compile"depends="codegen" 
description="Compiles all Java classes"> 





有 了 声明 好 的 这 些 依赖 ， 你 束 可 以 从 空 的 源 代码 目录 开始 ， 一 步 操 
作 就 完成 所 有 的 代码 生成 和 编译 处 理 : 





Sant compile 
Buildfile: build.xml 
prepare: 
[copy]Copying 3 files to/Users/jim/svn/oreilly/hib dev_2e/current 
/examples/ch07/classes 
usertypes: 
[javac]Compiling 2 source files 
to/Users/jim/svn/oreilly/hib_ dev 2e 
/current/examples/ch07/classes 
codegen: 
[hibernatetool]Executing Hibernate Tool with a Standard 
Configuration 
[hibernatetool]l.task: hbm2java (Generates a set of.java files) 
compile: 
[javac]Compiling 8 source files 
to/Users/jim/svn/oreilly/hib_ dev 2e 
/current/examples/ch07/classes 
BUILD SUCCESSFUL 
Total time: 3 seconds 




































































好 ， 我 们 回头 再 继续 学 习 目 定义 类 型 吧 。 


为 了 能 够 看 到 更 友好 的 提示 信息 〈 顺 便 也 测试 一 下 自 定义 持久 化 畏 
助 工 具 的 部 分 检索 功能 ) ， 我 们 可 以 扩充 一 下 查询 测试 ， 让 它 为 检索 回 
的 曲目 打印 输出 这 个 属性 关联 的 描述 。 必 要 的 修改 如 例 6-5 中 粗 体 字 部 
分 所 示 





all 


例 6-5: 在 QueryTest.java 中 显示 来 源 媒 介 信 息 





//Print the tracks that will fit in seven minutes 

List tracks=tracksNoLongerThan (Time.valueOf ("00: 07: 00") ， 
session) ; 

for (ListIterator iter=tracks.listIterator () ; 

iter.hasNext (); ) { 

Track aTrack= (Track) iter.next () ; 

Sst 

a 



































ring mediaInfo=""; 

CaTrack.getSourceMedia () ! =null) { 
mediaInfo=", from"+ 

aTrack.getSourceMedia () .getDescription () ; 
} 
System.out.println ("Track: \""+aTrack.getTitle () +"\""+ 
listArtistNames (aTrack.getArtists () ) + 
aTrack.getPlayTime () +medialInfo) ; 












































增加 了 这 些 扩充 的 代码 后 ， 运 行 ant qtest， 其 输出 结果 如 例 6-6 所 
Io RAJET Cnon-null) 来 源 媒介 值 的 曲目 后 面 会 跟着 一 个 "from"， 之 
后 显示 的 就 是 该 曲目 相应 的 媒介 描述 信息 。 











[java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 
[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 





49, 
from VHS Videocassette tape 

[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact Disc 

[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (William 
Orbit, Ferry Corsten, Samuel Barber) 00: 06: 35, from Compact Disc 
[java]Track: "Test Tone 1"00: 00: 10 

[java]Comment: Pink noise to test equalization 





























注意 ， 如 果 我 们 决定 在 QueryTest 中 不 自己 处 理 曲目 属性 子 集 的 格 
式 化 输出 ， 而 是 要 依靠 Track 类 的 toString() 方法 ， 那 么 我 们 不 需要 对 
QueryTest 进 行 任何 修改 就 可 以 看 到 这 种 新 的 输出 信息 ， 虽 然 用 数据 库 
查询 我 们 已 经 看 到 了 同样 的 枚 举 名 称 列表 的 最 简单 版 本 。 我 们 在 映射 文 
档 中 规定 toString() 方法 返回 的 结果 应 该 包含 sourceMedia 属 性 值 ， 该 
方法 负责 处 理 这 个 属性 值 。 可 以 检查 生成 的 toString() 方法 的 源 代码 
以 验证 这 一 点 ， 或 者 编写 一 段 简 单 的 程序 来 看 看 toString O 方法 输出 
的 结果 是 什么 样 的 。 当 然 ， 一 种 很 好 的 策略 就 是 修改 AlbumTest,java， 
让 它 在 我 们 修改 Track 以 后 可 以 通过 编译 并 运行 。 最 简单 的 修改 就 是 在 
addAlbumTrack() 方法 中 通过 硬 编 码 Chard-code) 让 每 个 曲目 都 来 自 
CD， 如 例 6-7 所 示 《〈JavaDoc 已 经 为 这 种 只 图 简单 的 做 法 想 好 了 理由 ) 。 











例 6-7: 修改 AlbumTestjava， 增 加 对 曲目 来 源 媒 介 的 支持 





/** 
*Quick and dirty helper method to handle repetitive portion of 
creating 








*album tracks.A real implementation would have much more 
flexibility. 

*/ 

private static void addAlbumTrack (Album album, String title, 
String file, 

Time length, Artist artist, int disc, 

int positionOnDisc, Session session) { 

Track track=new Track (title, file, length, new HashSet<Artist> 
C295 

new Date (), (short) 0, SourceMedia.CD, 

new HashSet<String> O ) ; 

track.getArtists () .add (artist) ; 

//session.save (track) ; 

album.getTracks () .add (new AlbumTrack (track, disc, 
positionOnDisc) ) ; 


} 
































修改 好 文件 以 后 ， 运 行 ant atest 命 令 ， 就 会 显示 在 Album 的 
toString O 方法 中 生成 的 来 源 媒介 信息 : 








[java]com.oreilly.hh.data.Album@ccad9c[title='Counterfeit 
e.p.'tracks=' [ 
com.oreilly.hh.data.AlbumTrack@9c0287[track='com.oreilly.hh.data.T 
title='Compulsion'sourceMedia='CD'J'], 
com.oreilly.hh.data.AlbumTrack@aa8eb7 
[track='com.oreilly.hh.data.Track@7fc8a0[title='In a Manner of 
Speaking'source 
Media='CD']'], 
com.oreilly.hh.data.AlbumTrack@4cadc4 [track='com.oreilly.hh.da 
ta.Track@243618[title='Smile in the Crowd'sourceMedia='CD']'], 
com.oreilly.h 
h.data.AlbumTrack@5b644b[track='com.oreilly.hh.data.Track@157e43[t 
sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@1483a0[track='com.oreilly 
-hh.data.Track@cdae24[title='Never Turn Your Back on Mother 
Earth'sourceMedia= 
"Cp Je 
com.oreilly.hh.data.AlbumTrack@63dc28 [track='com.oreilly.hh.data.Tra 
ck@ae511[title='Motherless Child'sourceMedia='CD'J']]"] 






































没有 做 多 少 工作 ， 我 们 就 利用 Hibernate 扩 展 了 能 够 支持 持久 化 的 类 


型 安全 的 枚 举 类 。 在 付出 一 定 的 努力 之 后 ， 就 可 以 像 Hibernate 文 持 的 其 
他 原生 值 类 型 一 样 ， 方 便 地 对 这 些 枚 举 类 进行 持久 化 。 


如 果 以 后 不 用 写 代码 ，Hibernate 中 支持 的 原生 类 型 可 以 直接 利用 
Java 5 文 持 的 enum 关 键 字 ， 那 就 太 好 了 。 不 过 ， 对 此 我 并 不 抱 多 少 希 
望 ， 因 为 Java 5 问世 已 经 有 一 段 时 间 了 。 但 是 ， 就 各 种 评论 来 说 ， 这 是 
一 种 “温和 ” (mild) 的 方法 ，Hibernate wiki 上 还 有 其 他 可 供 选 择 的 支持 
枚 举 类 型 的 用 户 自 定义 类 型 的 实现 。 


接 下 来 ， 我 们 将 介绍 如 何 映射 更 加 复杂 和 特殊 的 自 定 义 类 型 ， 没 有 
人 会 指望 Hibernate 能 够 为 这 么 复杂 的 类 型 映射 提供 内 建 的 文 持 。 





回想 一 下 ， 我 们 的 Track 对 象 中 有 个 属性 ， 用 于 决定 曲目 在 播放 时 
音量 的 大 小 。 假 设 我 们 希望 目 动 唱机 系统 除了 能 控制 曲目 的 音量 以 外 ， 
也 能 够 调整 播放 曲目 时 音质 的 均衡 度 Chalance) 。 为 了 实现 这 一 点 ， 我 
们 需要 为 左右 声 道 分 别 保存 音量 。 一 种 快速 的 解决 方案 就 是 编辑 Track 
映射 文档 ， 将 这 些 功能 要 求 映 冉 到 单独 的 属性 。 


如 果 我 们 严格 地 从 面向 对 象 架构 的 角度 来 考虑 ， 可 能 希望 将 这 两 个 
音量 值 封 装 到 一 个 StereoVolume 类 中 。 然 后 ， 再 将 这 个 类 直接 映射 到 一 
个 composite-element 元 素 ， 惑 像 我 们 在 例 5-4 中 对 AlbumTrack 组 件 所 做 的 
那样 。 这 依然 相当 直截了当 。 


不 过 ， 这 种 简单 的 解决 方案 有 个 缺点 。 系 统 中 的 其 他 地 方 可 能 也 需 
要 StereoVolume 值 。 如 果 我 们 建立 一 种 播放 列表 机 制 ， 它 可 以 改写 曲目 
默认 的 播放 选项 ， 同 时 又 能 对 整个 专辑 的 播放 首 量 进行 控制 。 突 然 间 ， 
我 们 就 得 在 好 几 个 地 方 重建 组 合 映 射 配 置 ， 而 且 有 可 能 无 法 保持 前 后 一 
臻 《对 于 更 复杂 的 复合 类 型 来 说 ， 这 更 可 能 是 个 问题 ， 但 现在 只 需要 有 
个 想法 就 可 以 了 ) 。Hibernate 参 考 文档 指出 ， 像 这 种 情况 ， 使 用 一 个 目 
定义 的 复合 类 (composite user type) 会 是 种 很 好 的 务实 做 法 ， 我 也 同意 


Si. 























应 该 怎么 做 


我 们 先 从 定义 StereoVolume 类 开始 做 起 。 没 有 理由 要 将 这 个 类 作为 
实体 (使 其 独立 存在 于 其 他 持久 化 对 象 以 外 ) ， 所 以 只 要 将 它 作为 普通 
的 《而 且 相 当 和 简单 的 ) Java 对 象 来 实现 即 可 。 例 6-8 展 示 了 它 的 代码 。 





注意 : 该 例 的 JavaDoc 经 过 精简 以 节省 空间 。 相 信 你 在 实际 项 目 中 


不 会 这 么 做 。 从 网 站 下 载 的 版 本 则 更 加 完整 。 








例 6-8: 一 个 用 于 表示 音量 等 级 的 值 类 (StereoVolume.java) 





package com.oreilly.hh; 

import java.io.Serializable; 

/** 

*A simple structure encapsulating a stereo volume level. 
*/ 
public class StereoVolume implements Serializable{ 
/**The minimum legal volume level.*/ 

public static final short MINIMUM=0; 

/**The maximum legal volume level.*/ 

public static final short MAXIMUM=100; 

/**Stores the volume of the left channel.*/ 
private short left; 
/**Stores the volume of the right channel.*/ 

private short right; 

/**Default constructor sets full volume in both channels.*/ 
public StereoVolume () {@ 

this (MAXIMUM, MAXIMUM) ; 

} 
/**Constructor that establishes specific volume levels.*/ 
public StereoVolume (short left, short right) { 

setLeft (left) ; 

setRight (right) ; 

} 

/** 

*Helper method to make sure a volume value is legal. 
*@param volume the level that is being set. 







































































































































































*@throws IllegalArgumentException if it is out of range. 
ad 

private void checkVolume (short volume) { 

if (volume<MINIMUM) { 

throw new IllegalArgumentException ("volume cannot be less than"+ 
MINIMUM) ; 
} 
i 






































f (volume>MAXIMUM) { 
throw new IllegalArgumentException ("volume cannot be more than"+ 
MAXIMUM) ; 


























/**Set the volume of the left channel.*/ 
public void setLeft (short volume) {©@ 
checkVolume (volume) ; 

left=volume; 

} 

/**Set the volume of the right channel.*/ 

public void setRight (short volume) { 

checkVolume (volume) ; 

right=volume; 

} 

/**Get the volume of the left channel*/ 

public short getLeft ©) { 

return left; } 

/**Get the volume of the right channel.*/ 

public short getRight () { 

return right; } 

/**Format a readable version of the volume levels, for 
debugging.*/ 

public String toString © { 

return"Volume[left="+leftt+", right="t+rightt+']'; 

} 

/** 

*Compare whether another object is equal to this one. 
*@param obj the object to be compared. 
*@return true if obj is also a StereoVolume instance, and 
represents 

*the same volume levels. 
ace 
public boolean equals (Object obj) {©@ 
if (obj instanceof StereoVolume) { 
StereoVolume other= (StereoVolume) obj; 
r 
O 
} 














































































































eturn other.getLeft () ==getLeft () && 
ther.getRight () ==getRight © ; 























return false; //It wasn't a StereoVolume 


} 


/** 


*Returns a hash code value for the StereoVolume.This method must 














xconsistent with the{@link#equals}method. 

x 

public int hashCode () { 

return (int) getLeft () *MAXIMUM*10+getRight () ; 
} 

} 











@ 办 为 我 们 想 用 Hibernate 持 久 化 这 个 对 象 ， 所 以 必须 提供 一 个 默认 
的 构造 函数 。 


QU KB PEW IA] AF o 


个 提供 对 Java equals © 和 hashCode () 比较 的 支持 也 是 重要 的 ， 
因为 这 是 一 个 可 变 值 对 象 。 


为 了 将 这 个 类 作为 复合 类 型 进行 持久 化 保存 ， 而 非 每 次 使 用 时 都 将 
其 定义 为 租 套 的 组 合 对 象 ， 我 们 需要 建立 一 个 复合 目 定义 类 型 来 管理 它 
的 持久 化 处 理 。 在 该 目 定 义 类 型 中 所 需要 提供 的 大 部 分 处 理 和 我 们 在 
SourceMediaType《〈 例 6-2， 本 章 前 面 演示 的 一 个 例子 ) 中 提供 的 将 不 
多 。 所 以 这 里 只 集中 介绍 新 鲜 而 有 趣 的 内 容 。 例 6-9 演 示 了 以 复合 自 定 
义 类 型 的 方式 来 持久 化 StereoVolume 类 的 一 种 方法 。 


例 6-9: 用 于 持久 化 StereoVolume 的 复合 自 定 义 类 型 


(StereoVolumeType.java) 





package com.oreilly.hh; 

































































import java.io.Serializable; 

import java.sql.PreparedStatement; 

import java.sql.ResultSet; 

import java.sgql.SQLException; 

import org.hibernate.Hibernate; 

import org.hibernat ngine.SessionImplementor; 

import org.hibernate.type.Type; 

import org.hibernate.usertype.CompositeUserType; 

/** 

*Manages persistence for the{@link StereoVolume}composite type. 








E 

public class StereoVolumeType implements CompositeUserType{ 

/** 

*Get the names of the properties that make up this composite type, 
and 

*that may be used in a query involving it. 














public String[]getPropertyNames () {0 

//Allocate a new response each time, because arrays are mutable 

return new String[]{"left", "right"}; 

} 

/** 

*Get the types associated with the properties that make up this 
composite 


*type. 


* 























*@return the types of the parameters reported 
by{@link#getPropertynames}, 
* 








in the same order. 

ay 

public Type[]getPropertyTypes () { 

return new Type[]{Hibernate.SHORT, Hibernate.SHORT}; 

} 

/** 

*Look up the value of one of the properties making up this 


composite type. 
* 














*@param component a{@link StereoVolume}instance being managed. 
*@param property the index of the desired property. 

*@return the corresponding value. 
* 
* 








@see#getPropertyNames 
/ 
public Object getPropertyValue (Object component, int property) 10 
StereoVolume volume= (StereoVolume) component; 

short result; 

switch (property) { 

case 0: 








result=volume.getLeft () ; 

break; 

case 1: 

result=volume.getRight () ; 

break; 

default: 

throw new IllegalArgumentException ("unknown 
property: "+property) ; 

} 

return new Short (result) ; 

} 

/** 

*Set the value of one of the properties making up this composite 
type. 




















@param component a{@link StereoVolume}instance being managed. 
@param property the index of the desired property. 

@object value the new value to be established. 
@see#getPropertyNames 











public void setPropertyValue (Object component, int property, 
Object value) { 
StereoVolume volume= (StereoVolume) component; 
short newLevel= ( (Short) value) .shortValue O) ; 
switch (property) { 
case 0: 
volume.setLeft (newLevel) ; 
break; 
case 
volume.setRight (newLevel) ; 
break; 
default: 
throw new IllegalArgumentException ("unknown 
property: "+property) ; 
} 
} 
/** 
*Determine the class that is returned by{@link#nullSafeGet}. 


* 



































*@return{@link StereoVolume}, the actual type returned by 
* 
{@link#nullSafeGet}. 

are 

public Class returnedClass () { 
return StereoVolume.class; 

} 

/** 


*Compare two instances of the class mapped by this type for 























persistence 

















*"Yegquality". 

大 

*@param x first object to be compared. 

*@param y second object to be compared. 

*@return<code>true</code>iff both represent the same volume 
levels. 


* 


P 
Be 


/ 














@throws ClassCastException if x or y isn't a{@link StereoVolume}. 








ublic boolean equals (Object x, Object y) 10 
if (x==y) { 


//This is a trivial success 


return true; 


/ 


r 


} 











f (x==null||y==null) {//Don't blow up if either is null! 





eturn false; 





/Now it's 
eturn ( (S 














safe to delegate to the class'own sense of equality 
tereoVolume) x) .equals (y); 


























/** 

*Return a deep copy of the persistent state, stopping at entities 
and 

*COLLECELONS 

大 

*@param value the object whose state is to be copied. 

*@return a copy representing the same volume levels as the 
original. 

*@throws ClassCastException for non{@link StereoVolume}values. 

x 

public Object deepCopy (Object value) 10 

if (value==null) 

return null; 

StereoVolume volume= (StereoVolume) value; 

return new StereoVolume (volume.getLeft () , volume.getRight O ); 

} 

/** 

*Indicates whether objects managed by this type are mutable. 


* 





*@return<code>true</code>, since{@link StereoVolume}is mutable. 


* 


/ 





public boolean isMutable () { 
return true; 


} 
/ 


火 1 


大 大 


ResultSet}. 


* 


* 





@param rs 











Retrieve an instance of the mapped class from a JDBC{@link 





the results from which the instance should be 


retrieved. 
*@param names the columns from which the instance should be 
retrieved. 
*@param session an extension of the normal Hibernate session 
interface 
*that gives you much more access to the internals. 
*@param owner the entity containing the value being retrieved. 
*@return the retrieved{@link StereoVolume}value, or<code>null 
</code>. 
*@throws SQLException if there is a problem accessing the 
database. 
ae 
public Object nullSafeGet (ResultSet rs, String[]names, @ 
SessionImplementor session, Object owner) 
throws SQLException { 
Short left= (Short) Hibernate.SHORT.nullSafeGet (rs, names[0]) ; 
Short right= (Short) Hibernate.SHORT.nullSafeGet (rs, names[1]) ; 
if (left==null||right==null) { 
return null; //We don't have a specified volume for the channels 





































































































return new StereoVolume (left.shortValue () ， 
right.shortValue O ); 

} 

/** 

*Write an instance of the mapped class to a{@link 
PreparedStatement}, 

*handling null values. 











* 





@param st a JDBC prepared statement. 
*@param value the StereoVolume value to write. 
*@param index the parameter index within the prepared statement at 
which 
*this value is to be written. 
*@param session an extension of the normal Hibernate session 
interface 

*that gives you much more access to the internals. 
*@throws SQLException if there is a problem accessing the 
database. 

*/ 

public void nullSafeSet (PreparedStatement st, Object value, int 
index, 

SessionImplementor session) 

throws SQLException f{ 
if (value==null) { 
Hibernate.SHORT.nullSafeSet (st, null, index) ; 
Hibernate.SHORT.nullSafeSet (st, null, index+1) ; 
jelse{ 
StereoVolume vol= (StereoVolume) value; 

















































































































Hibernate. SHORT.nullSafeSet (st, new Short (vol.getLeft © ) , 
index) ; 

Hibernate.SHORT.nullSafeSet (st, new Short (vol.g 

index+1) ; 

} 

} 

/** 

*Reconstitute a working instance of the managed class from the 


cache. 
* 









































tRight ©), 


(0) 











*@param cached the serializable version that was in the cache. 
*@param session an extension of the normal Hibernate session 
interface 
that gives you much more access to the internals. 
*@param owner the entity containing the value being retrieved. 
*@return a copy of the value as a{@link StereoVolume}instance. 
Ai 
public Object assemble (Serializable cached, SessionImplementor 
session, @ 

Object owner) { 

//Our value type happens to be serializable, so we have an easy 
out. 

return deepCopy (cached) ; 

} 

/** 

*Translate an instance of the managed class into a serializable 
form to be 


*stored in the cache. 
* 















































*@param session an extension of the normal Hibernate session 
interface 
that gives you much more access to the internals. 
*@param value the StereoVolume value to be cached. 
*@return a serializable copy of the value. 
xy 
public Serializable disassemble (Object value, SessionImplementor 
session) { 

return (Serializable) deepCopy (value) ; 

} 

/** 

*Get a hashcode for the instance, consistent with 
persistence"equality" 

eh 

public int hashCode (Object x) {@ 

return x.hashCode () ; //Can delegate to our well-behaved object 

} 

/** 


*During merge, replace the existing (target) value in the entity 












































we are 

*merging to with a new (original) value from the detached entity 
we are 

*merging.For immutable objects, or null values, it is safe to 
simply 

*return the first parameter.For mutable objects, it is safe to 
return a 

xcopy of the first parameter.However, since composite user types 

often 

*define component values, it might make sense to recursively 
replace 


*component values in the target object. 
* 





















































*@param original value being merged from. 
*@param target value being merged to. 
*@param session the hibernate session into which the merge is 
happening. 
*@param owner the containing entity. 
*@return an independent value that can safely be used in the new 
context. 
ay 
public Object replace (Object original, Object target, Q 
SessionImplementor session, Object owner) { 
return deepCopy (original) ; 
} 
} 





























Oh +A T getPropertyNames () 和 getPropertyTypes © 方法 ， 
Hibernate sh FY LA Ani 2H OZ RL A EB. a SQL AE HI 
就 可 以 使 用 这 些 值 类 型 。 在 这 个 例子 中 它们 相当 于 我 们 正在 持久 化 的 实 
际 StereoVolume 类 的 属性 值 ， 但 不 是 必需 的 。 例 如 ， 我 们 可 以 借 这 个 机 
会 来 为 根本 不 是 为 持久 化 而 设计 的 遗留 〈legacy) 类 提供 一 个 友好 的 属 
PERE 





全 复合 用 户 定 义 类 型 的 虚拟 属性 和 它们 基于 的 真实 数据 之 间 转 换 是 
由 getPropertyValue () 和 setPropertyValue O 方法 提供 的 。 在 本 质 上 ， 


Hibernate 只 是 给 了 我 们 一 个 想 要 管理 的 类 型 的 实例 ， 而 且 没有 一 点 假 

w, EAT, BRACE, REIL TREK EAN 
这 个 值 "。 你 可 以 看 到 如 何 用 这 种 方法 为 旧 的 或 第 三 方 代码 增加 属性 接 
口 。 在 这 个 例子 中 ， 因 为 我 们 实际 上 不 需要 这 种 功能 ， 我 们 要 将 属性 处 
理 传 递 给 底层 的 StereoVolume 类 ， 这 里 要 路 越 的 障碍 只 是 模板 类 。 


接 下 来 的 一 大 段 代 码 由 前 面 例 6-2 中 见 过 的 方法 组 成 ， 不 过 例子 中 
的 版 本 具有 的 一 些 区 别 很 有 意思 。 大 部 分 变化 与 前 面 提 到 的 内 容 有 关 ， 
不 像 SourceMedia， 我 们 的 StereoVolume 类 是 可 变 的 ， 它 包含 了 可 变化 的 
值 。 所 以 ， 我 们 得 为 一 些 最 终 适 合 的 方法 设计 出 完整 的 实现 。 





全 我 们 需要 在 equals() 中 提供 一 种 有 意义 的 方法 来 比较 实例 。 
四 还 要 在 deepCopy O 中 实现 独立 的 实例 复制 。 


加 实际 的 持久 化 方法 CnullSafeGet O 和 nullSafeSet © ) 与 例 6-2 
非常 相似 ， 只 有 一 点 不 同 ， 我 们 对 此 不 需要 过 多 介绍 。 它 们 都 有 一 个 
SessionImplementor 参 数 ， 通 过 这 个 参数 可 以 访问 让 Hibernate 正 常 工作 的 
内 部 组 件 。 只 有 真正 复杂 的 持久 化 处 理 才 需要 使 用 这 个 参数 ， 这 已 经 超 
出 本 书 介绍 的 范围 。 如 果 你 需要 使 用 SessionImplementor 方 法 ， 在 实现 
上 相当 有 技巧 ， 必 须 深刻 理解 Hibernate 的 体系 结构 。 其 实 你 正 写 的 是 对 
系统 的 扩展 ， 可 能 需要 研究 源 代码 才能 获得 必需 的 专业 知识 。 











Q@assemble () 和 disassemble O 方法 可 以 让 自 定 义 类 型 支持 对 非 


Serializable 值 的 缓存 。 它 们 让 我 们 的 持久 化 工具 方法 有 机 会 可 以 将 任何 
重要 的 值 复制 到 另 一 个 能 够 被 序列 化 (serialized〉 的 对 象 中 (使 用 任何 
必要 的 手段 )。 因 为 让 StereoVolume 首 先 成 为 可 序列 化 的 并 不 重要 ， 我 
们 也 不 需要 这 种 灵活 性 ， 所 以 我 们 的 实现 只 是 为 了 能 保存 在 缓存 中 复制 
一 些 可 序列 化 的 StereoVolume 实 例 (之 所 以 要 复制 实例 ， 是 因为 我 们 的 
数据 类 是 可 变 的 ， 不 应 该 让 缓存 值 也 莫名 其 妙 地 发 生变 化 ) 。 








@hashCode () 方法 是 Hibernate 3 中 新 增加 的 方法 ， 虽 然 需要 修改 
CompositeUserType 实 现 ， 但 它 有 助 于 提高 效率 。 在 这 个 例子 中 ， 我 们 
有 一 个 对 象 已 经 实现 了 这 个 方法 ， 可 以 将 处 理 委 托 给 这 个 对 象 。 但 是 ， 
FAR Va), TER TT TE AE H oe — EE at BBP, De 
DBL A ENS “NE Java C28 at o 








OJ, replace O 方法 是 Hibernate 3 要 求 的 另 一 个 新 方法 。 再 一 
次 ， 因 为 我 们 需要 复制 一 个 对 象 ， 可 以 用 一 种 容易 的 办 法 来 实现 。 男 
外 ， 我 们 也 可 以 手工 将 所 有 内 磐 的 属性 值 从 最 初 的 对 象 复制 到 目标 对 
象 。 


注意 : 这 么 一 个 简单 的 值 类 居然 需要 做 这 么 多 的 工作 。 但 是 ， 这 正 
古 对 更 复杂 的 值 类 进行 建 模 的 好 起 后 。 








好 了 ， 这 头 “ 野 兽 ” 已 经 创建 完成 ， 接 下 来 应 该 怎么 用 ? 为 了 使 用 该 
新 的 复合 类 型 ， 例 6-10 改 进 了 Track 映射 文档 中 volume 属 性 的 配置 ， 同 时 


为 了 便于 查看 测试 的 输出 ， 也 趁 此 机 会 将 它 加 到 了 toString O 方法 
中 。 


例 6-10: 修改 Track.hbm.xml 以 使 用 StereoVolume 





<property name="volume"type="com.oreilly.hh.StereoVolumeType" > 


























<meta attribute="field-description">How loud to play the track 
</meta> 
<meta attribute="use-in-tostring">true</meta> 


<column name="VOL LEFT"/> 
<column name="VOL RIGHT"/> 
</property> 

















再 次 注意 ， 映 射 文档 中 提供 的 是 负责 管理 持久 化 的 目 定义 类 型 的 名 
称 ， 而 不 是 它 所 管理 的 原始 类 型 。 这 与 例 6-3 是 一 样 的 。 此 外 ， 这 个 复 
合 类 型 使 用 两 个 字段 存储 数据 ， 所 以 这 里 也 得 提供 两 个 字段 名 称 。 


现在 ， 当 我 们 执行 ant codegen 命 令 ， 为 Track 重新 生成 Java 源 代码 
时 ， 可 以 得 到 例 6-11 所 示 的 结果 。 


例 6-11: 新 生成 的 Track.java 源 代码 的 变动 之 处 





*How loud to play the track 

4 

private StereoVolume volume; 

public Track (String title, String filePath, Date playTime, 
Set<Artist>artists, Date added, 

StereoVolume volume, SourceMedia sourceMedia, 
Set<String>comments) { 











*How loud to play the track 
mE 
public StereoVolume getVolume () { 

return this.volume; 

} 

public void setVolume (StereoVolume volume) { 
this.volume=volume; 








public String toString O) 4 
StringBuffer buffer=new StringBuffer () ; 













































































buffer.append (getClass () .getName () ) .append ("@") .append (Integ 
(hashCode () ) ) .append ("[") ; 

buffer.append ("title") .append ("='") .append (getTitle (©) ) .appenc 
buffer.append ("volume") .append ("='") .append (getVolume () ) .appe 
buffer.append ("sourceMedia") .append ("='") .append (getSourceMedié 
wr) ; 











buffer.append ("]") ; 
return buffer.toString © ; 























此 时 ， 可 以 执行 ant schema 命 令 来 重建 数据 库 表 ， 例 6-12 演 示 了 相 
关 的 结果 。 


例 6-12: 根据 新 的 映射 而 创建 的 曲目 数据 库 模 式 





[hibernatetool]create table TRACK (TRACK ID integer generated by 
default as 
identity (start with 1) , TITLE varchar (255) not null, 
filePath varchar (255) not null, playTime time, added date, 
VOL LEFT smallint, VOL RIGHT smallint, sourceMedia varchar (255) ， 
primary key (TRACK ID) ); 












































让 我 们 进一步 改进 数据 创建 的 测试 程序 ， 使 其 能 够 采用 新 的 Track 
结构 。 例 6-13 演 示 了 我 们 需要 做 出 的 修改 。 





例 6-13: 对 CreateTest.java 做 必要 的 修改 以 测试 立体 声音 量 





//Create some data and persist it 
tx=session.beginTransaction () ; 
StereoVolume fullVolume=new StereoVolume () ; 

Track track=new Track ("Russian Trance", 
"vyol2/album610/track02.mp3", 

Time.valueOf ("00: 03: 30") ， 

new HashSet<Artist> O, 

new Date (), fullVolume, SourceMedia.CD, 

new HashSet<String> O ) ; 

addTrackArtist (track, getArtist ("PPK", true, session) ) ; 
session.save (track) ; 












































//The other tracks created use fullVolume too, until... 





track=new Track ("Test Tone 1", 

"vyol2/singles/test01l.mp3", 

Time.valueOf ("00: 00: 10") , new HashSet<Artist> O, 

new Date () , new StereoVolume ( (short) 50, (short) 75) ; 

null, new HashSet<String> (O) ) ; 

track.getComments () .add ("Pink noise to test equalization") ; 
session.save (track) ; 








现在 ， 如 果 我 们 执行 ant ctest， 并 用 ant db 查看 结果 ， 就 会 看 到 如 图 
6-2 所 示 的 结果 。 


8 jdt hsglab-datasnwusic 

E ALBUM 

E ALBUM _ARTETS 

E ALBUM_COMMENTS 

E ALBUM TRACKS 

@ ARTIST 

E TRACK 
schema: PUBLIC 
TRACK ID 


Russian Trance 
Video Killed the Radio Star 


S TITLE Gravity's Angel 
@ FILEPATH Adagio for Strings (Ferry Corsten Remix) 100 


国 PLAYTIME Adagio for Strings (ATS Remix) 100 
5 AKER The World ‘4 164 
加 VOL.LEFT Test Tone 1 50 
Type: SMALLINT 
Nullable- true 
@ YOL.RIGHT 
Type: SMALLINT 
Nullable: true 
国 SOURCEMEDIA 
E indices 
-E TRACE_ARTETS 





A 6-2 TRACK 表 中 的 立体 声音 量 信息 


为 了 让 AlbumTest 与 新 的 Track 格式 保持 兼容 ， 我 们 只 需要 对 
AlbumTest 做 一 处 修改 ， 如 例 6-14 上 所 示 。 


例 6-14: 对 AlbumTestjava 所 做 的 修改 ， 以 文 持 立体 声 曲目 音量 





private static void addAlbumTrack (Album album, String title, 
String file, 

Time length, Artist artist, int disc, 

int positionOnDisc, Session session) { 

Track track=new Track (title, file, length, new HashSet<Artist> 
CDs 

new Date () , new StereoVolume () , SourceMedia.CD, 

new HashSet<String> © ); 























这 样 我 们 就 可 以 ; 


运 
= A 





方法 所 显示 的 音 














例 6-15: 带 有 立体 声音 量 信息 的 专辑 


{Fant atest 命 令 ， 查 看 新 版 的 Track 的 toString ©) 
言 已 ， 如 例 6-15 所 示 。 





[java]com.oreilly.hh.data.Album@ccad9c[title='Counterf 
"{com.oreilly.hh.data.AlbumTrack@9c0287[track='com.oreills 


e.p. 


right=100 


'tracks= 
sourceMedia= 


] 1 


iCD]! 


] ，C 


eit 





om.oreilly.hh.data.AlbumTrack@aa8eb7 [track='com.oreilly.hh.data.Track( 























































































































itle='In a Manner of Speaking'volume='Volume[left=100, 
right=100] 'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@4cadc4 [track='com.oreilly.hh.data.Tra 
ck@243618[title='"Smile in the Crowd'volume='Volume[left=100, 
right=100]'sourc eMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@5b644b[track='com.oreilly.hh.d 
ata.Track@157e43 [title='Gone'volume='Volume[left=100, 
right=100]'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@1483a0[track='com.oreilly.hh.data.Tra 
ck@cdae24[title='Never Turn Your Back on Mother 
Barth'volume='Volume[left=100, right=100] 'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@63dc28 [track='com.oreilly.hh.data.Tracl 
Child'volume='Volume[left=100, right=100] 'sourceMedia='CD']']]"] 

咖 ， 这 里 介绍 的 内 容 可 能 深入 了 一 点 ， 超 过 了 你 目前 对 自 定 义 类 
所 需要 的 程度 。 但 是 ， 总 有 一 天 你 也 许 会 回 过 头 来 深入 研究 这 个 例子 ， 


找到 你 正在 寻找 的 主题 。 


同时 ， 接 下 来 让 我 们 换 档 去 看 一 看 完全 不 同 、 








全 新 而 且 简 单 的 事物 。 第 7 章 将 介绍 一 种 完全 取代 XML 映射 文档 的 方 
法 。 第 8 章 将 介绍 条 件 查 询 ， 这 是 Hibernate 独 特 的 功能 ， 对 于 程序 员 来 
说 这 个 功能 非常 友好 。 


其 他 


映射 自 定义 类 型 还 有 哪些 奇特 的 诀 客 ?” 好 吧 ， 如 果 本 章 介 绍 的 信息 
还 不 够 用 ， 你 可 以 研究 一 下 org.hibernate.usertype 包 中 的 其 他 接口 ， 包 括 
EnhancedUserType (这 个 接口 将 自 定义 类 型 作为 实体 的 d， 以 及 其 他 有 
趣 的 窃 门 )》 和 ParameterizedUserType 〈 可 以 配置 它 支持 多 种 不 同类 型 的 
Wet) 等 。 在 Hibernate 维 基 的 Java5 EnumUserType (!!!) 页 面 上 也 讨 
论 了 针对 Java 5 enum 枚 举 类 型 的 可 重用 映射 ， 这些 都 很 好 地 演示 了 各 种 
用 法 ， 只 是 对 它们 的 讨论 己 经 超出 了 本 书 的 范围 。 


[1] http:/ /www.hibernate.org/272.html. 


第 7 章 BR IE 


到 目前 为 止 ， 我 们 一 直 在 用 XML 映射 文档 作为 我 们 示例 的 起 点 。 
在 这 种 情况 下 ， 以 一 个 概念 模型 作为 开始 ， 将 创建 数据 表 和 数据 对 象 的 
细节 都 留 给 Hibernate， 同 时 也 保留 很 多 可 供 选 择 的 余地 。 然 而 ，Java5 
对 标注 〈Annotation) 机 制 提供 了 有 灵活 的 文 持 ， 这 一 技术 的 出 现 为 
Hibernate 映 射 提供 了 一 种 非常 有 趣 的 符 代 方法 。 尤 其 是 当 你 已 经 拥有 了 
一 些 现 有 的 对 象 ， 只 是 在 考虑 怎么 将 它们 保存 到 数据 库 时 ， 就 是 这 种 新 
的 符 代 方法 的 适用 场合 了 。 





Hibernate 标 注 


如 果 你 以 前 从 没有 接触 过 标注 ， 本 章 的 代码 示例 将 看 起 来 有 点 奇 
怪 ， 所 以 ， 现 在 最 好 先 花 点 时 间 讨 论 一 下 Java 标 注 的 历史 和 目的 。 基 本 
上 ， 一 个 标注 就 是 为 一 段 代 码 添加 一 些 信息 《在 Java 世 界 中 ， 通 常 是 一 
个 类 、 字 段 或 方法 ) ， 以 便 帮 助 其 他 工具 理解 如 何 使 用 这 段 代 码 ， 或 是 
进行 共 些 自动 化 处 理 以 节约 你 的 工作 量 。 与 持久 化 映射 不 同 的 是 ， 为 了 
与 源 代 码 保持 一 致 ， 不 用 将 标注 放 到 一 个 单独 的 文件 中 ， 而 是 直接 将 标 
注 放 在 它 所 影响 的 源 代码 文件 中 。 采 用 这 种 方法 ， 你 就 不 用 担心 与 源 代 
码 分 离 保 存 的 文件 是 人 否 会 变 得 与 源 代码 不 同步 了 。 早 在 Java 5 为 这 种 编 
码 风 格 提供 健壮 的 文 持 以 前 ， 人 们 束 通 过 利用 JavaDoc 工 具 可 扩展 的 特 























性 ， 发 现 了 一 种 取得 这 种 支持 的 “后 门 ”。 





JavaDoc 也 是 一 种 形式 的 标注 ， 从 Java 开 始 就 一 直 存 在 ， 它 的 目的 
是 让 开发 人 员 为 他 们 的 类 和 API 生 成 高 质量 的 文档 ， 而 且 还 不 必 维 护 除 
源 代码 以 外 的 任何 文件 。JavaDoc 的 工作 效果 非常 好 ， 所 以 人 们 就 想 用 
它 来 做 些 其 他 事情 。XDoclet( 叫 ) 项 目 是 一 个 很 流行 ， 而 且 也 比较 复 
杂 的 框架 ， 它 以 多 种 有 趣 的 方式 对 JavaDoc 进 行 了 扩展 。Hibernate 也 开 
发 了 一 套 丰富 的 Hibernate XDoclet 标 签 。 








也 正 因为 这 种 方法 的 功能 如 此 强大 ， 所 以 Sun 在 Java 5 中 内 建 了 完整 
的 、 通 用 的 标注 支持 。 这 样 ， 就 不 再 需要 那些 借用 JavaDoc 注 释 的 复杂 
工具 了 。 现 在 Java 编 译 器 本 身 就 可 以 处 理 标注 〈 并 提供 了 它 自己 的 一 些 
标注 来 控制 单独 的 类 、 方 法 甚至 字段 上 的 特定 警告 信息 ) 。 利 用 反射 
(reflection) 机 制 来 解析 标注 《如 果 将 它们 配置 为 要 保留 在 编译 后 的 类 
中 ) ， 也 能 够 非常 容易 地 定义 自己 的 标注 类 。 所 以 ，Hibernate 自 然 采 用 
了 Java 5 的 原生 (native) 标注 。 








趋同 进化 〈convergent evolution) 的 速度 如 此 之 快 ， 使 用 标注 为 类 
配置 映射 的 能 力 具 有 的 强大 吸引 力 ， 已 经 让 Hibernate 自 己 的 标签 深 深 地 
影响 了 EJB 3 规范 。 如 此 有 用 的 Hibernate 风 格 的 持久 化 要 是 能 够 在 成 熟 
的 Java Enterprise Edition (EE) 环境 以 外 也 可 以 使 用 ， 这 给 人 们 留 下 深 
刻 的 印象 ， 所 以 他 们 定义 了 Java Persistence API (经 常 称 为 JPA〉， 作 为 
一 种 可 以 在 普通 的 Java Standard Edition (SE) 环境 可 以 独立 使 用 的 持久 








化 组 件 。 因 为 有 规范 作为 基础 ，Hibernate 自 然 会 采用 直接 支持 它们 ， 所 
以 现在 通过 EJB 3 和 JPA 接 口 以 及 标注 ， 也 可 以 使 用 Hibernate 能 够 提供 的 
许多 功能 ， 而 应 用 程序 本 号 根本 不 必 依 赖 (或 知道 ) Hibernate. 


我 们 不 打算 介绍 那么 多 功能 ， 因 为 我 们 在 Hibernate 中 使 用 的 一 些 功 
能 需要 使 用 它 自 己 的 标签 。 事 实 上 ， 在 你 习惯 使 用 Hibernate， 并 领会 到 
它 是 一 种 非常 灵活 而 强大 的 体系 ， 可 以 “按照 你 需要 的 任何 方式 ， 持 久 
化 任何 普通 Java 对 象 " 以 后 ， 你 会 发 现 按照 JPA 规 范 的 要 求 来 封装 你 的 代 
码 将 不 得 不 考虑 太 多 的 限制 ， 除 非 项 目 确实 强制 要 求 需 要 屏蔽 底层 的 持 
久 化 实现 《可 能 你 会 想 办 法 尽量 避免 这 样 的 项 目 ) 。 不 过 ， 如 果 你 正在 
使 用 Hibernate， 有 时 使 用 标注 而 不 是 XML 文 件 来 配置 映射 ， 也 是 一 种 不 
错 的 选择 。 











为 何在 意 


在 熟悉 了 标注 的 语法 以 后 (一 些 像 Eclipse 之 类 的 IDE 已 经 提供 了 惊 
人 的 能 力 ， 支 持 标 注 的 理解 、 文 档 化 以 及 自动 完成 ， 甚 至 自 定义 供 你 自 
己 使 用 的 标注 ， 第 14 章 将 介绍 这 种 技术 ) ， 编 写 映 射 文档 就 只 需要 涉及 
一 种 文件 格式 的 建立 和 读 取 了 。 





注意 : 什么 ! 为 什么 不 早点 介绍 这 么 酷 的 东西 ? 


如 前 所 述 ， 如 果 将 数据 对 象 和 映射 规定 都 放 在 同一 个 文件 中 ， 那 么 


它们 不 能 保持 同步 的 可 能 性 就 很 小 ， 阅 读 代 码 也 可 以 马上 理解 正在 进行 
的 处 理 。 添 加 标注 后 的 代码 将 是 一 种 目 文档 化 的 〈self-documenting) 代 
码 。 一 些 标注 提供 的 默认 设置 经 常 也 可 以 减少 你 需要 进行 配置 的 工作 
量 。 用 标注 指定 所 有 设置 ， 你 会 发 现 标 注 语 法 比 XML 文 件 更 精简 ， 而 
且 需 要 输入 的 文字 量 比较 少 ， 或 者 让 IDE 帮 你 完成 输入 后 ， 只 要 读 一 下 


PLAT LAS 








当 你 可 以 直接 控制 数据 库 时 ， 这 种 方法 可 能 会 很 有 成 效 ， 只 是 这 种 
方法 会 将 映射 和 数据 对 象 紧密 地 厢 合 在 一 起 〈 或 者 ， 如 果 你 正在 设计 数 
据 对 象 以 处 理 特定 的 、 固 定格 式 的 数据 库 结构 ， 这 样 也 同样 会 产生 紧密 
Hatt) 。 这 音 味 着 ， 如 果 你 想 用 一 个 对 象 模型 来 支持 多 个 数据 库 ， 使 用 
标注 就 不 是 一 种 好 的 选择 了 ; 在 这 种 情况 下 ， 外 部 映射 文件 的 独立 性 其 
实 是 它 的 优势 ， 因 为 不 需要 修改 Java 源 代码 ， 只 要 为 不 同 的 数据 库 提 供 
单独 的 映射 文件 就 可 以 了 。 





许多 其 他 Java 工 具 也 采用 标注 作为 配置 和 集成 的 手段 ， 第 13 章 将 介 
绍 相 关内 容 。 在 使 用 这 些 工 具 时 ， 同 时 也 使 用 Hibernate 的 标注 也 是 非常 
方便 的 。 其 实 ， 其 他 工具 可 能 也 要 依赖 Hibernate 标 注 。 就 算 我 们 不 计划 
在 本 书 的 新 版 中 介绍 标注 的 使 用 ， 介 绍 Spring 的 那 一 章 也 会 强制 我 们 面 


对 这 一 问题 。 


对 于 标注 的 批评 之 一 就 是 它 让 数据 库 细 节 分 散 到 Java 源 代码 的 各 个 
角落 。 所 入 ， 一 些 有 用 的 Hibernate 工 具 可 以 根据 Hibernate XML 映射 文 


件 和 Hibernate 标 注 生 成 Hibernate 映 射 文档 。 有 关 hbm2doc 的 更 多 信息 ， 
参阅 第 12 章 的 12.8.2 节 。 





应 该 怎么 做 


我 们 需要 做 的 第 一 件 事 就 是 更 新 Maven 的 依赖 配置 ， 让 它 取 回 
Hibernate 标 注 库 。 编 辑 build.xml 文 件 中 的 依赖 设置 ， 如 例 7-1 所 示 《增加 
的 部 分 用 粗 体 显示 ) 。 


例 7-1: 获得 Hibernate 标 注 











<artifact: dependencies pathId="dependency.class.path"> 
<dependency groupid="hsqldb"artifactId="hsqldb"version="1.8.0.7"/ 








> 

















<dependency groupId="o0rg.hibernate"artifactId="hibernate" 

version="3.2.5.ga"> 

<exclusion groupId="javax.transaction"artifactId="jta"/> 

</dependency> 

<dependency groupId="org.hibernate"artifactId="hibernate-tools" 

version="3.2.0.beta9a"/> 

<dependency groupId="o0rg.hibernate"artifactId="hibernate- 
annotations" 

version="3.3.0.ga"/> 

<dependency groupId="org.hibernate" 

artifactId="hibernate-commons-annotations" 

version="3.3.0.ga"/> 

<dependency groupId="o0rg.apache.geronimo.specs" 

artifactId="geronimo-jta_1.1 spec"version="1.1"/> 

<dependency groupid="log4j"artifactId="log4j"version="1.2.14"/> 

</artifact: dependencies> 


























































































































在 这 个 文件 中 ， 删 除 usertypes 和 codegen 两 个 构建 目标 。 因 为 我 们 要 
使 用 标注 ， 所 以 就 不 用 生成 Java 代 码 了 。 另 一 方面 ， 我 们 将 从 Java 代 三 


文件 入 手 ， 用 它 来 定义 Hibernate 映 射 〈 以 及 数据 库 模 式 ) ， 所 以 在 本 章 
中 应 该 废弃 这 两 个 构建 目标 (它们 甚至 是 危险 的 )。 








可 以 想到 ， 为 了 适应 这 种 新 方法 ， 还 需要 对 schema 构 建 目 标 稍 微调 
整 一 下 ， 如 例 7-2 中 突出 显示 部 分 所 示 。 


例 7-2: 使 用 标注 生成 数据 库 模 式 











<! --Generate the schemas for annotated classes-->@ 

<target name="schema"depends="compile" 

description="Generate DB schema from the annotated model 
classes"> 

<hibernatetool destdir="${source.root}"> 

<classpath refid="project.class.path"/>@ 

<annotationconfiguration 

configurationfile="${source.root}/hibernate.cfg.xml"/>®@ 

<hbm2ddl1 drop="yes"/> 

</hibernatetool> 

</target> 






































@ 需 要 更 新 注释 和 构建 目标 描述 ， 以 反映 新 的 工作 方式 。 





人 @ 我 们 需要 引用 编译 好 的 类 ， 以 便 模式 生成 工具 可 以 找到 其 中 的 标 
注 。 注 意 ， 这 意味 着 在 生成 模式 之 前 ， 需 要 先 把 类 编译 好 ， 这 样 的 处 理 
顺序 与 该 构建 目标 前 面 的 大 多 数 版 本 都 不 相同 ， 但 是 在 第 6 章 中 增加 了 
这 个 依赖 ， 所 以 我 们 的 schema 构 建 目标 已 经 依赖 编译 目标 了 。 











全 最 后 ， 让 工具 使 用 标注 来 配置 它 自 己 。 我 们 仍旧 提供 一 个 全 局 的 
Hibernate 配 置 文件 ， 以 便 工 具 可 以 知道 我 们 正在 使 用 什么 数据 库 等 信 
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文件 后 ， 我 们 再 处 理 它 。 


我 们 的 compile 构 建 目标 需要 依赖 刚才 删除 挥 的 代码 生成 构建 目 
标 ， 所 以 在 删除 这 一 依赖 以 前 ， 这 个 构建 目标 不 能 运行 。 在 我 们 的 新 方 
法 中 ， 为 了 文 持 编译 而 所 有 需要 做 的 就 是 让 基本 的 prepare 构 建 目 标 可 以 
运行 。 编 辑 compile 构 建 目标 ， 以 反映 例 7-3 中 突出 显示 部 分 的 变化 。 





例 7-3: 更 简单 的 编译 依赖 








<! --Compile the java source of the project--> 
<target name="compile"depends="prepare" 
description="Compiles all Java classes"> 
<javac srcdir="S{source.root}" 
destdir="${class.root}" 
debug="on"optimize="off"deprecation="on"> 
<classpath refid="project.class.path"/> 
</javac> 

</target> 





























如 前 面 所 述 ， 我 们 需要 更 新 Hibernate 配 置 ， 将 原来 使 用 的 映射 文档 
列表 蔡 换 为 相应 标注 过 的 类 (annotated classes) 的 列表 。 删 除 那 些 映射 
文档 ， 修 改 src 目 录 下 hibernate.cfg.xml 文 件 的 末尾 部 分 ， 如 例 7-4 所 示 
同样， 需要 修改 的 部 分 以 粗 体 字 显 示 ) 。 








例 7-4: 配置 Hibernate 使 用 标注 





<! --Don't echo all executed SQL to stdout--> 
<property name="show sql">false</property> 








<! --disable batching so HSQLDB will propagate errors correctly.- 





<property name="jdbc.batch size">0</property> 

<! --List all the annotated classes we're using--> 
<mapping class="com.oreilly.hh.data.Album"/> 
<mapping class="com.oreilly.hh.data.AlbumTrack"/> 
<mapping class="com.oreilly.hh.data.Artist"/> 
<mapping class="com.oreilly.hh.data.Track"/> 
</session-factory> 

</hibernate-configuration> 



































ATA 么 做 


你 可 能 会 问 ， 为 什么 需要 在 配置 文件 中 列 出 标注 过 的 类 ? Hibernate 
不 能 通过 类 的 标注 而 自己 找到 它们 ? 嗯 ， 可 以 找到 它们 ， 如 果 你 修改 编 
码 风 格 ， 完 全 依靠 JPA 接 口 〈 使 用 JPA EntityManager 的 Hibernate 实 现 ， 
而 不 是 使 用 Hibernate Session) ， 不 用 告诉 Hibernate 到 哪 找 标注 过 的 类 
Hibernate 自 己 就 可 以 找到 它们 ， 真 令 人 高 兴 。 但 是 ， 如 前 面 所 述 ， 本 书 
不 打算 在 标注 上 做 过 多 介绍 。 如 果 坚 持 使 用 Hibernate 的 原生 接口 ， 就 应 
该 显 式 声明 用 于 执行 持久 化 的 类 ， 即 使 是 在 使 用 标注 来 控制 持久 化 时 ， 
也 应 该 这 么 做 。 











我 们 差不多 已 经 做 好 准备 工作 了 ， 就 兰 用 标注 过 的 类 来 组 成 这 种 方 
法 的 核心 ! 接 下 来 就 介绍 本 章 真 正 有 趣 的 部 分 ， 看 看 数据 对 象 的 Java 源 
代码 标注 长 得 什么 样 儿 ， 么 控制 Hibernate 映 射 的 。 


[1] http://xdoclet.sourceforge.net/xdoclet/index.html. 
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可 以 在 许多 Java 元 素 上 应 用 标注 。 在 使 用 Hibernate 时 ， 通 常 关注 的 
是 对 类 和 它 的 字段 进行 标注 ， 以 指定 如 何 将 模型 对 象 映射 到 数据 库 模 
式 。 这 类 似 于 XML 了 映射 文档 是 被 映射 的 类 和 属性 的 结构 化 描述 方式 。 
已 经 进行 了 足够 的 背景 介绍 和 解释 ， 接 下 来 就 深入 主题 ， 以 具体 的 实例 
《在 第 6 章 中 开发 的 完整 例子 ) 来 看 看 如 何 使 用 标注 对 类 进行 映射 。 











应 该 怎么 做 


例 7-5 演 示 了 一 种 对 Artist 类 进行 标注 的 方法 。 本 章 只 是 介绍 
Hibernate Annotations 的 基础 ， 如 果 你 想 更 加 彻底 地 了 解 这 些 标注 ， 请 参 
考 Hibernate Annotations 项 目 网 站 ， 它 的 网 址 是 
http://annotations.hibemmate.org (''!) 。 为 了 节省 篇 幅 ， 对 下 载 的 完整 源 
代码 中 的 标注 类 进行 了 一 定 的 压缩 ， 压 缩 了 空白 字符 ， 省 略 了 JavaDoc 
注释 。 由 于 这 些 源 代码 是 手工 编写 的 类 ， 而 不 是 像 前 几 章 中 用 代码 生成 
工具 生成 的 类 ， 所 以 就 有 空间 为 这 些 代码 加 入 更 多 、 更 详细 的 JavaDoc 
注释 。 建 议 你 也 看 看 下 载 到 的 源 代码 ， 很 有 价值 。 





例 7-5: 标注 Artist 类 





package com.oreilly.hh.data; 


import java.util.*; 

import javax.persistence.*; @ 

import org.hibernate.annotations. Index; 

Entity@ 

Table (name="ARTIST") 

NamedQueries ({ 

NamedQuery (name="com.oreilly.hh.artistByName"; 

query="from Artist as artist where upper (artist.name) =upper (: 

















@ 
@ 
@ 
@ 

















}) 

public class Artist{ 

erd® 

@Column (name="ARTIST ID") 














@GeneratedValue (strategy=GenerationType.AUTO) 
private Integer id; 
@Column (name="NAME", nullable=false, unique=true) @ 
@Index (name="ARTIST NAME", columnNames={"NAME"}) © 
private String name; 
@ManyToMany® 
@JoinTable (name="TRACK ARTISTS", 
joinColumns={@JoinColumn (name="TRACK ID") }, 
inverseJoinColumns={@JoinColumn (name="ARTIST ID") }) 
private Set<Track>tracks; 
@ManyToOne@ 
@JoinColumn (name="actualArtist") 
private Artist actualArtist; 
public Artist () {} 
public Artist (String name, Set<Track>tracks, Artist 
actualArtist) { 
this.name=name; 
this.tracks=tracks; 
this.actualArtist=actualArtist; 
} 
public Integer getId () {return id; } 
public void setId (Integer id) { 
this.id=id; 
} 
public String getName () {return name; } 
public void setName (String name) { 
this.name=name; 
} 
public Artist getActualArtist () {return actualArtist; } 
public void setActualArtist (Artist actualArtist) { 
this.actualArtist=actualArtist; 
} 
public Set<Track>getTracks () {return tracks; } 
public void setTracks (Set<Track>tracks) { 
this.tracks=tracks; 



































































































































} 

/** 
*Produce a human-readable representation of the artist. 
* 














*@return a textual description of the artist. 

af 

public String toString © { 

StringBuilder builder=new StringBuilder () ; 

builder.append (getClass () .getName () ) .append ("@") ; 
builder.append (Integer.toHexString (hashCode O) ) ) .append ("[{") ; 
b 

b 

b 




















uilder.append ("name") .append ("='") .append (getName () ) .append 
uilder.append ("actualArtist") .append ("='") .append (getActualArt 
uilder.append ("'") .append ("]") ; 

return builder.toString () ; 

} 

} 

















@ 为 了 使 用 非 核心 Java 语 言 自 身 的 标注 ， 例 如 我 们 在 这 里 讨论 的 与 
持久 化 相关 的 标注 ， 得 先导 入 它们 。 标 注 其 实 也 只 是 Java 类 《尽管 这 些 
类 会 实现 一 个 特殊 的 接口 ， 但 它们 的 声明 方法 有 些 意思 ， 相 关 介 绍 已 经 
超出 本 章 讨 论 的 范围 ， 有 兴趣 的 话 可 以 阅读 第 14 章 ) ， 上 所 以 使 用 普通 的 
import 语 句 像 这 样 导入 它们 就 可 以 了 。 





a 





如 前 所 述 ， 我 们 在 这 里 需要 使 用 的 大 多 数 标注 都 是 由 标准 的 EJB 3 
标注 〈 在 javax.persistence 包 中 定义 ) 演化 而 来 的 。 我 们 之 所 以 需要 一 个 
Hibernate 特 定 的 标注 ， 是 为 了 能 够 获得 一 个 特定 的 索引 Maven 会 自动 下 
载 并 让 我 们 能 够 使 用 Java Persistence API， 因 为 我 们 在 更 新 过 的 
build.xml 中 要 求 它 是 Hibernate Annotations 的 一 个 依赖 。 我 们 可 以 像 这 样 
单独 地 使 用 Java Persistence API， 因 为 JDK 中 专门 设计 让 它 在 Java SE 环 
境 中 可 以 单独 使 用 ， 在 Java EE 中 也 内 建 了 一 部 分 对 EJB 的 支持 。 如 果 你 
想 了 解 更 多 内 容 ， 它 的 主页 〈 丫 ) 就 是 一 个 好 的 起 点 。 


多 应 用 到 Artist 类 上 的 这 组 标注 是 一 个 整体 。Entity 标 注 将 这 个 类 标 
记 为 可 持久 化 的 。Table 标 注 是 可 选 的 ， 标 注 处 理 器 将 为 标注 提供 非常 
合理 的 默认 假设 ， 但 是 我 们 在 这 里 想 演 示 如 何 明 确 地 指定 表 名 ， 以 防止 
把 错误 的 名 称 连接 到 现 有 的 数据 库 。 


注意 : 这 种 查询 语言 关系 表明 在 很 大 程度 上 Hibernate 确 实 影响 了 
EJB 3 的 发 展 方向 。 


那么 我 们 的 查询 在 Java 源 代码 中 到 底 做 了 什么 ? 唤 ， 这 是 在 使 用 标 
注 时 ，Hibernate 原 生 接 口 表现 出 来 的 另 一 个 缺点 : 没有 放置 命名 查询 的 
地 方 。 如 果 我 们 使 用 JPA EntityManager， 就 可 以 将 命名 查询 放 在 一 个 
persistence.xml 文 件 中 ， 这 样 就 保留 了 将 SQL 语 句 和 Java 源 代 人 码 互相 分 离 
的 优点 。 由 于 在 本 书 中 我 们 坚持 使 用 会 话 接 口 ， 这 样 当 我 们 使 用 标注 而 
不 是 XML 映射 文件 时 ， 就 丧失 了 使 用 命名 查询 的 优点 。 但 是 我 们 仍然 
可 以 用 HQL 编 写 查 询 ， 使 用 它 的 所 有 功能 。 如 果 换 用 JPA 接 口 ， 就 得 使 
用 JPAQL ( 它 是 HQL 的 一 个 子 集 ) 。 











全 这 里 演示 了 如 何 标 注 映 射 属性 。 这 是 一 个 特殊 的 例子 ， 因 为 要 标 
注 的 属性 也 是 对 象 的 惟一 标识 符 ， 如 @Id 标 注 所 示 。 可 以 用 标注 指定 不 
同 的 ID 生成 策略 ， 就 像 用 Hibernate 的 XML 映射 文档 一 样 〈 标 注 旨 在 完 
全 取代 现 有 O/R 层 的 功能 ， 标 准 的 JPA 选 择 以 及 Hibernate 自 己 的 标注 ， 
实际 上 你 差不多 可 以 做 想 要 的 任何 事情 了 ) 。 为 生成 风格 选择 AUTO， 
相当 于 在 XML 中 指定 二 generator class="native> 的 基于 标注 的 等 价 


物 。 它 告诉 Hibernate 使 用 对 于 数据 库 来 说 最 目 然 的 任何 处 理 方法 。 


与 实体 级 的 标注 一 样 ， 你 可 以 省 略 一 些 选 择 《〈 例 如 列 名 ) ， 默 认 的 
选项 就 相当 合理 ， 但 我 们 在 这 里 想 演示 当 你 有 特殊 需要 时 如 何 进行 配 
置 。 事 实 上 ， 根 本 不 需要 为 属性 添加 标注 一 JPA 将 假设 实体 的 所 有 属性 
都 要 映 冉 ， 除 非特 别 指定 (要 是 通过 标注 的 话 ， 上 自然 是 : @Transient 用 
于 这 一 目的 ) 。 








也 要 注意 ， 我 们 是 将 标注 加 到 了 实际 的 字段 ， 而 不 是 访问 器 方法 
上 。 这 是 告诉 Hibernate 直 接 访问 字段 ， 而 访问 器 在 一 个 类 中 适合 在 运行 
时 为 其 他 类 提供 抽象 ， 但 这 样 与 持久 化 又 不 能 保持 兼容 。 在 许多 情况 
下 ， 你 可 能 想 让 Hibernate 使 用 访问 器 方法 ， 只 要 将 标注 放 到 相应 的 
getter 或 setter 方 法 上 就 可 以 了 。 你 需要 挑 出 一 个 方法 或 其 他 方法 ， 但 属 
性 之 间 的 混合 和 匹配 还 不 支持 (通过 JPA， 再 加 上 Hibernate 的 一 些 扩 
展 .……. 即 便 你 能 够 这 样 做 ， 也 可 能 引起 其 他 的 混乱 ) 。 


@@ 当 对 列 进行 映射 时 ， 可 以 用 许多 可 选 的 属性 来 控制 映射 结果 ， 例 
如 是 人 否 为 null、 人 惟一 约束 等 等 ， 就 像 在 XML 映射 文件 中 的 配置 一 样 。 


加 为 了 能 够 指定 一 个 列 应 该 有 一 个 索引 《以 及 如 何 建 立 索 引 ) ， 是 
我 们 在 这 个 例子 中 增加 Hibernate 标 注 的 一 个 原因 。@Index 标 签 不 是 标准 
JPA 标 注 的 一 部 分 ， 它 是 一 个 有 用 的 Hibernate 扩 展 。 使 用 这 个 标注 就 让 
我 们 的 代码 需要 依靠 Hibernate， 但 除了 这 是 一 本 有 关 Hibernate 的 书 这 一 





事实 以 外 ， 如 前 所 述 〈 后 面 也 会 介绍 ) ， 还 有 许多 原因 可 以 解释 为 什么 
你 将 经 党 要 做 出 同样 的 选择 。 


@ 和 映射 文档 一 样 ， 在 关联 配置 上 也 有 更 多 的 选项 。 在 这 个 例子 
中 ， 我 们 描述 了 一 个 Track 之 间 的 多 对 多 关系 ， 显 式 地 描述 出 在 数据 库 
中 如 何 表达 这 一 关系 。 








人 @ 有 时 你 不 需要 在 标注 中 配置 很 多 东西 ， 即 使 你 很 清楚 这 些 配置 。 
这 个 例子 是 为 了 演示 标注 为 何 要 比 XML 了 映射 文件 更 加 简洁 。 我 们 使 用 
@JoinColumn 标 注 来 设置 列 名 “〈 与 基于 XML 的 配置 方法 一 样 ) 。 如 果 没 
有 这 个 标注 ， 也 能 正常 运行 ， 但 是 默认 的 列 名 稍微 有 点 元 长 : 
ACTUALARTIST_ARTIST_ID. 











除了 以 上 这 段 代码 ， 这 个 类 没什么 可 介绍 的 了 ， 它 是 一 个 简单 的 数 
据 bean， 与 前 几 章 中 根据 映射 文档 生成 的 数据 类 非常 相似 。 下 载 到 的 代 
码 中 的 JavaDoc 注 释 ， 详 细 的 解释 了 字段 和 方法 的 作用 ， 比 前 面 用 工具 
生成 的 代码 中 的 注释 详细 多 了 。 





这 个 标注 过 的 类 生成 的 ARTIST 数 据 表 ， 与 前 面 几 章 中 根据 
Artisthbm.xml 映 射 文档 而 得 到 的 ARTIST 表 完全 相同 。 


标注 Track 类 


标注 过 的 Artist 类 需要 引用 Track 类 。 例 7-6 演 示 了 Track 类 中 的 标 
注 ， 其 中 也 引入 了 一 些 新 的 问题 。 


例 7-6: 标注 Track 类 





package com.oreilly.hh.data; 















































import java.sgl.Time; 

import java.util.*; 

import javax.persistence.*; 

import org.hibernate.annotations.CollectionOfElements; 
import org.hibernate.annotations. Index; 

@Entity 

@Table (name="TRACK" ) 

@NamedQueries ({ 

@NamedQuery (name="com.oreilly.hh.tracksNoLongerThan", 
query="from Track as track where track.playTime<=: length") 
}) 

public class Track{ 

QId 

@Column (name="TRACK_ID") 








@GeneratedValue (strategy=GenerationType.AUTO) 
private Integer id; 

@Column (name="TITLE", nullable=false) 

@Index (name="TRACK TITLE", columnNames={"TITLE"} ) 
private String title; 

@Column (nullable=false) 

private String filePath; 

@Temporal (TemporalType.TIME) @ 

private Date playTime; 

@ManyToMany 

@JoinTable (name="TRACK ARTISTS", 
joinColumns={@JoinColumn (name="ARTIST ID") }, 
inverseJoinColumns={@JoinColumn (name="TRACK ID") }) 
private Set<Artist>artists; 

@Temporal (TemporalType.DATE) @ 

private Date added; 
@CollectionOfElements® 
@JoinTable (name="TRACK COMMENTS", 
joinColumns=@JoinColumn (name="TRACK_ID") ) 
@Column (name="COMMENT" ) 

private Set<String>comments; 

@Enumerated (EnumType.STRING) @ 

private SourceMedia sourceMedia; 

































































































































































col 


@Embedded® 

@AttributeOverrides (10 
@AttributeOverride (name="left", 
lumn=@Column (name="VOL LEFT") ) , 
@AttributeOverride (name="right", 












































col 











lumn=@Column (name="VOL RIGHT") ) 

p) 

StereoVolume volume; 

public Track () {} 

public Track (String title, String filePath) { 
this.title=title; 
this.filePath=filePath; 

} 
public Track (String title, String filePath, Time playTime, 
Set<Artist>artists, Date added, StereoVolume volume, 
SourceMedia sourceMedia, Set<String>comments) { 
this.title=title; 
this.filePath=filePath; 
this.playTime=playTime; 
this.artists=artists; 
this.added=added; 
this.volume=volume; 
this.sourceMedia=sourceMedia; 
this.comments=comments; 

} 
public Date getAdded () {return added; } 
public void setAdded (Date added) { 
this.added=added; 

} 
public String getFilePath () {return filePath; } 
public void setFilePath (String filePath) { 
this.filePath=filePath; 

} 
public Integer getId () {return id; } 
public void setId (Integer id) { 
this.id=id; 























































































































public Date getPlayTime () {return playTime; } 
public void setPlayTime (Date playTime) { 
this.playTime=playTime; 

















public String getTitle ©) {return title; } 
public void setTitle (String title) { 
this.title=title; 























public Set<Artist>getArtists () {return artists; } 
public void setArtists (Set<Artist>artists) { 
this.artists=artists; 














} 

public Set<String>getComments () {return comments; } 
public void setComments (Set<String>comments) { 
this.comments=comments; 

} 

public SourceMedia getSourceMedia () {return sourceMedia; } 
public void setSourceMedia (SourceMedia sourceMedia) { 
this.sourceMedia=sourceMedia; 

} 

public StereoVolume getVolume () {return volume; } 
public void setVolume (StereoVolume volume) { 
this.volume=volume; 


} 









































public String toString () {@ 

StringBuilder builder=new StringBuilder () ; 

builder.append (getClass () .getName () ) .append ("@") ; 
builder.append (Integer.toHexString (hashCode () ) ) .append ("[") ; 
builder.append ("title") .append ("='") .append (getTitle () ) .apper 
builder.append ("volume") .append ("='") .append (getVolume () ) .apr 
builder.append ("sourceMedia") .append ("='") .append (getSourceMedi 
builder.append ("'") .append ("]") ; 


return builder.toString (©) ; 








种 与 日 期 类 型 Date〈 或 者 是 时 间 戳 timestamp， 包 括 时 间 和 日 期 ) 相 
比 ， 由 于 Java 缺 少 明 确 的 类 来 表示 一 天 中 的 时 间 ， 我 们 就 需要 一 种 方法 
来 声明 如 何 使 用 Date 类 。@Temporal 标 注 提 供 了 这 样 的 功能 。 在 这 个 例 
子 中 我 们 标注 playTime 对 应 于 SQL 中 的 TIME 列 。 如 果 忽 略 这 个 标注 ， 默 
认 的 列 类 型 将 是 TIMESTAMP。 


@added 属 性 ， 虽 然 它 与 playTime 具 有 同样 的 Date 类 型 ， 但 对 应 于 一 
个 DATE 列 。 


全 @CollectionOfElements 标 注 也 是 一 个 Hibernate 扩 展 ， 对 于 到 简单 


值 类 型 集合 的 关联 ， 它 为 我 们 控制 这 些 类 型 映射 到 的 表 和 列 提 供 了 一 种 
更 简单 的 方法 。 这 是 我 们 之 所 以 要 使 用 非 标准 标注 的 主要 原因 之 一 。 使 
用 纯 JPA， 就 根本 不 能 直接 映射 简单 值 类 型 〈 例 如 String 或 Integer) 的 集 
合 。 这 需要 声明 一 个 完整 的 实体 类 来 持 有 这 样 的 值 ， 接 着 再 映射 这 个 
类 。 对 于 那些 习惯 用 Hibernate 映 射 POJO (Plain Old Java Object) 的 灵活 
性 的 人 ， 这 可 能 是 一 大 退步 。 


人 @ 男 一 方面 ， 对 于 内 建 枚 举 类 型 的 映射 ，JPA 提 供 了 强大 的 支持 ， 
这 是 Java 5 enum 问 世 以 来 给 我 们 带 来 的 一 个 好 处 (类 型 安全 的 枚 举 类 型 
模式 的 广泛 采纳 成 束 了 这 一 语言 功能 ) 。 这 个 标注 比 我 们 在 第 6 章 中 用 
过 的 要 更 加 简单 ! 

加 这 是 用 JPA 标 注 来 映射 复合 目 定 义 类 型 的 标准 用 法 ， 相 当 于 例 6- 


10。JPA 规 范 要 求 当 我 们 进行 这 样 的 映射 时 ， 同 时 要 将 StereoVolume 类 
标记 为 可 般 入 的 : 





package com.oreilly.hh.data; 

import java.io.Serializable; 

import javax.persistence.Embeddable; 

/** 

*A simple structure encapsulating a stereo volume level. 
ee 

@Embeddable 

public class Stereovolume implements Serializable{ 























(事实 上 ，Hibernate 可 以 很 容易 地 映射 散 套 类 ， 而 不 由 我 们 做 这 些 


BUTI LYE. AED EN ACT WAS BY Bes EP REP EL, AT 
PAF NIE TD St IFC ALS 2) 





@ 再 一 次 ， 我 们 添加 了 超过 实际 需要 的 标注 ， 为 的 是 生成 与 基于 
XML 的 映射 版 本 的 例子 中 完全 一 样 的 数据 库 模 式 。 如 果 不 用 
@AttributeOverrides 标 注 ， 用 于 保存 两 个 音量 的 列 将 是 LEFT 和 
RIGHT 〈StereoVolume 类 中 的 属性 名 称 ) ， 而 不 是 VOL_LEFT 和 





VOL_RIGHT. 


@ 为 了 让 我 们 的 测试 程序 可 以 打印 输出 与 原来 的 旧 方 法 一 样 的 信 
我 们 复制 了 Hibemate 代 人 码 生 成 费 为 我 们 创建 的 toString(〉 实现 。 注 
， 我 们 可 以 借 这 个 机 会 来 更 新 它们 ， 使 用 StringBuilder， 而 没有 必要 
非得 使 用 线程 安全 (BI) (但 速度 更 慢 ) 的 StringBuffer。 


ct 


ely 


这 套 标 注 可 以 创建 TRACK、TRACK_ARTISTS 以 及 
TRACK_COMMENTS 数 据 表 ， 与 例 2-1 到 例 6-10 中 使 用 Track.hbm.xml 生 
成 的 数据 库 模 式 一 样 。 


标注 Album 类 


Album 类 是 目前 我 们 构建 的 其 他 示例 的 核心 模型 类 。 例 7-7 演 示 了 如 
何 对 它 进 行 标注 ， 以 重新 创建 我 们 正在 处 理 的 数据 库 模式 和 映射 ， 同 时 
也 引入 几 个 不 用 再 多 介绍 的 概念 。 





例 7-7: 标注 Album 类 





package com.oreilly.hh.data; 


persistence.*; 











bernate.annotations.CollectionOfElements; @ 











bernate.annotations. Index; 




















bernate.annotations.IndexColumn; 





import java.util.*; 
import javax. 
import org.hi 
import org.hi 
import org.hi 
Entity 








e 
@ 
public class 
Q 








@GeneratedVal 








private Strin 











joinColumns=@ 
inverseJoinCo 


Table (name="ALBUM" ) 





Album { 


@Column (name="ALBUM ID") 











ue (strategy=GenerationType. AUTO) 


private Integer id; 
@Column (name="TITLE", nullable=false) 
@Index (name="ALBUM TITLE", columnNames={"TITLE"}) 












































g title; 


@Column (nullable=false) 

private Integer numDiscs; 

@ManyToMany (cascade=CascadeType.ALL) 
@JoinTable (name="ALBUM ARTISTS", 




















JoinColumn (name="ARTIST_ID") ， 
lumns=@JoinColumn (name="ALBUM ID") ) 




















private Set<Artist>artists; 


@CollectionOf] 





Elements 








joinColumns=@ 


@JoinTable (name="ALBUM COMMENTS", 








JoinColumn (name="ALBUM_ID") ) 











@Column (name="COMMENT" ) 

















private Date 





private Set<String>comments; 
@Temporal (TemporalType. DATE) 





added; 








@CollectionO£ 











joinColumns=@ 


Elements@ 
@IndexColumn (name="LIST POS") (3) 
@JoinTable (name="ALBUM TRACKS", 








JoinColumn (name="ALBUM ID") ) 











private List<AlbumTrack>tracks; 








public Album () {} 
public Album (String title, int numDiscs, Set<Artist>artists, 
Set<String>comments, List<AlbumTrack>tracks, 














Date added) { 

















this.title=ti 


tle; 





this.numDiscs 





=numDiscs; 








this.artists=artists; 
this.comments=comments; 





} 

pub 
pub 
thi 


pub 





this.tracks=tracks; 
this.added=added; 


lic Date getAdded () {return added; } 
lic void setAdded (Date added) { 





s.added=added; 





lic 











lic 














nteger getId () {return id; } 














lic void setId (Integer id) { 
s.id= 


id; 


nteger getNumDiscs () {return numDiscs; } 





lic void setNumDiscs (Integer numDiscs) { 
s.numDiscs=numDiscs; 


lic String getTitle () {return title; } 
lic void setTitle (String title) { 











s.title=title; 





ub] 
tring 





lic List<AlbumTrack>getTracks () {return tracks; } 
lic void setTracks (List<AlbumTrack>tracks) { 





s.tracks=tracks; 











lic Set<Artist>getArtists () {return artists; } 
lic void setArtists (Set<Artist>artists) { 

















-artists=artists; 


lic Set<String>getComments () {return comments; } 
lic void setComments (Set<String>comments) { 
-comments=comments; 





Lic String toString () { 
Builder builder=new StringBuilder () ; 











uil 
uil 
uil 


p 

S 
builder. 
buil 
b 
b 
b 


der. 
der. 
der. 
der. 





append (getClass () .getName () ) .append ("@") ; 

append (Integer.toHexString (hashCode () ) ) .append ("[") ; 
append ("title") .append ("='") .append (getTitle () ) .apper 
append ("tracks") .append ("='") .append (getTracks () ) .apr 
append ("]") ; 














return builder.toString () ; 





} 
} 








四 是 的 ， 没 有 Hibernate 特 定 的 扩展 ， 还 是 不 行 。 在 这 个 类 中 至 少 需 
要 3 个 引用 的 类 。 


人 AlbumTrack 不 是 一 个 实体 〈 它 没有 ID 属性 ， 脱 离 了 Album 记 录 ， 
惑 不 能 独立 地 碍 询 它 们 的 实例 ) 。 所 以 我 们 使 用 @CollectionOfElements 
标注 ( 束 像 我 们 前 面 映射 基本 类 型 一 样 )， 而 不 是 @OneToMany 用 于 
PRT SEAS) 。 





全 对 于 集合 映射 ，JPA 和 EJB 只 支持 set 之 类 的 语义 。 如 第 5 章 所 述 ， 
能 够 以 特定 的 顺序 来 保存 记录 也 很 重要 ， 这 就 是 为 什么 我 们 要 使 用 像 
List 和 array (数组) 之 类 的 数据 结构 ，Hibernate 可 以 容易 地 映射 这 种 有 
序 集合 。 不 过 ， 如 果 只 用 JPA， 融 无 法 映射 这 样 的 集合 了 ! Hibernate 的 
@IndexColumn 扩 展 提 供 了 一 种 权宜 之 计 。 








把 这 个 标注 和 @JoinColumn 信 息 组 合 在 一 起 ， 就 可 以 让 Hibernate 生 
成 与 基于 例 5-4 中 的 Album.hbm.xml 而 得 到 数据 库 模 式 完 全 一 样 的 结果 ， 
其 中 ALBUM_TRACKS 表 具有 一 个 复合 主键 (由 ALBUM_ID 和 
LIST_POS 组 成 ) 。 


Album 类 与 AlbumTrack 类 密切 相关 ，AlbumTrack 的 标注 过 程 如 例 7- 
8 所 示 ， 同 样 也 会 重新 创建 我 们 的 示例 数据 库 模 式 。 


例 7-8: 标注 AlbumTrack 类 





package com.oreilly.hh.data; 

import java.io.Serializable; 

import javax.persistence.*; 
@Embeddable® 

public class AlbumTrack{ 

@ManyToOne (cascade=CascadeType.ALL) @ 

















@JoinColumn (name="TRACK_ID", nullable=false) 
private Track track; 
private Integer disc; ® 
private Integer positionOnDisc; 
public AlbumTrack () {} 
public AlbumTrack (Track track, Integer disc, Integer 
positionOnDisc) { 
this.track=track; 
this.disc=disc; 
this.positionOnDisc=positionOnDisc; 






































public Track getTrack () {return track; } 
public void setTrack (Track track) { 
this.track=track; 

} 
public Integer getDisc () {return disc; } 

public void setDisc (Integer disc) { 

this.disc=disc; 

} 

public Integer getPositionOnDisc () {return positionOnDisc; } 
public void setPositionOnDisc (Integer positionOnDisc) { 
this.positionOnDisc=positionOnDisce; 


} 



































ublic String toString () { 

tringBuilder builder=new StringBuilder () ; 

uilder.append (getClass () .getName () ) .append ("@") ; 
uilder.append (Integer.toHexString (hashCode () ) ) .append ("[") ; 
uilder.append ("track") .append ("='") .append (getTrack (©) ) .apper 
uilder.append ("]") ; 

return builder.toString () ; 

} 

} 























oO O FO ND 








@@ 下 如 前 面 对 Album 类 映射 的 讨论 ， 这 个 类 是 一 个 不 可 以 独立 存在 
的 实体 ， 所 以 我 们 用 @Embeddable 进 行 标注 ， 和 StereoVolume 的 映射 一 
样 。 


全 即使 不 是 实体 ， 我 们 也 需要 告诉 Hibernate 如 何 处 理 track 属 性 ， 这 
个 属性 会 引用 一 个 实体 。 如 果 没 有 这 个 标注 ， 试 图 构建 数据 库 模式 就 会 


失败 。 这 个 标注 也 让 我 们 能 够 保留 基于 XML 的 方法 中 使 用 同样 的 列 名 
称 。 美 中 不 足 的 是 ， 到 Track 类 的 级 联 请 求 还 不 足以 在 创建 新 专辑 时 目 
动 地 保存 曲目 ， 所 以 稍 后 我 们 将 需要 回 到 AlbumTest 类 的 早期 版 本 。 在 
本 章 的 7.3 节 中 ， 我 们 将 探 完 一 种 能 够 重新 获得 这 种 上 自动 级 联 的 模式 生 
成 方法 。 





全 最 后 这 两 个 属性 表明 ， 在 使 用 标注 时 ， 有 时 你 根本 不 需要 提供 任 
何 标注 。 虽 然 这 两 个 属性 声明 附近 什么 也 没有 ， 但 确实 能 够 被 映射 ， 标 
注 处 理 器 提供 的 默认 处 理 可 以 实现 我 们 想 要 的 映射 。 


这 个 类 的 其 他 部 分 相当 直接 ， 比 其 他 几 个 例子 看 起 来 更 简短 ， 因 为 
需要 省 理 的 ID 属 性 ， 只 有 其 他 一 些 简单 属性 。 


如 前 所 述 ， 这 段 代 码 中 的 映射 要 求 我 们 在 创建 新 的 专辑 时 ， 重 新 负 
责 保存 曲目 对 象 。 例 5-13 中 Album.hbm.xml 最 终 的 映射 配置 不 需要 我 们 
负责 保存 曲目 ， 所 以 我 们 注释 掉 了 AlbumTest.java 的 addAlbumTrack () 
中 调用 session.save (track〉 的 那 行 代码 。 现 在 我 们 需要 取消 对 这 行 的 注 
释 ， 这 样 才 会 与 例 5-8 保 持 一 致 。 











可 以 有 效 吗 


编辑 好 所 有 代码 后 ， 接 下 来 就 可 以 创建 数据 库 模式 了 。 例 7-9 演 示 
了 我 们 现在 用 这 种 基于 标注 的 方法 ， 在 运行 ant schema 命 令 后 ， 得 到 的 





大 部 分 结 


式 化 。 


例 7- 


果 。 其 中 ， 为 了 方便 阅读 ， 对 创建 表格 的 语句 行进 行 了 重新 格 








9: 使 用 标注 过 的 类 来 创建 数据 库 模式 (重点 部 分 ) 





Sant 





schema 


Buildfile: build.xml 








Down] 


oading: org/hibernate/hibernat 











annotations/3.3.0.ga/hibernate-annotations- 


ERAS] 
Trans 


.ga.pom@ 
ferring 1K 








Down] 


oading: org/hibernate/hibernate/3.2.1.ga/hibernate- 








Be2 lea 
Trans 
Downl 





. pom 
ferring 3K 
oading: javax/persistence/persistence-api/1.0/persistence- 





api-1.0.pom 


Trans 





ferring 1K 





Down] 





-—commons— 





oading: org/hibernate/hibernat 


annotations/3.3.0.ga/hibernate-comm 
ons-annotations-3.3.0.ga.pom 


Trans 





ferring 1K 





Down] 








oading: org/hibernate/hibernat 





annotations/3.3.0.ga/hibernate-annotations-—- 


3.35.0 
Trans 
Downl 
api-1.0. 
Trans 
Down] 





jar 


.ga. jar 
ferring 258K 
oading: javax/persistence/persistence-api/1.0/persistence- 





ferring 50K 
oading: org/hibernate/hibernate-commons- 








annotations/3.3.0.ga/hibernate-comm 


ons-a 
Trans 
prepa 


[copy] 


examp 
compi 
[java 


to/Users/jim/svn/oreilly/hibern 


nnotations-3.3.0.ga.jar 

ferring 64K 

re: 

Copying 1 file to/Users/jim/svn/oreilly/hibernate/current/ 
les/ch07/classes 

le: 

c]Compiling 10 source 











files 
ate/ 











current/examples/ch07/classes 
schema: 
[hibernatetool]Executing Hibernate Tool with a Hibernate 


Annotation/EJ] 

















B3 Config 





urati 


ono 






































| (Generates database schema) 


table ALBUM ARTISTS drop constraint 



























































ALBUM if 

















table TRACK COMMENTS 


ljalter table TRACK COMMENTS drop constraint 


exists; 





if exists; 











ID integer generated by 














[hibernatetool]1l.task: hbm2dd] 
[hibernatetool]alter 
FK7BA403FCB99A6003; 
[hibernatetoo 
FK105B2688E424525B; 
[hibernatetool]drop table 
[hibernatetool]drop 
[hibernatetool 
default 
as iden 
TITLE varchar (255) not null, 











primary key (ALI 
[hibernatetool]crea 


null, 
ALBUM ID 














BUM_ 








integer not 


primary key (ART 





[hibernatetool]create 


null, 














null, 
disc integer, 








[hibernatetool]creat 


default 





ID) ); © 





Ce 








ST 











table ALBUM ARTI 


ull, 


n 
D, ALBUM ID) ) ; 




















COMMENT varchar (255) ) ; 
[hibernatetool]create table ALI 





positionOnDisc integer, 


LIST_POS integer not 
primary key (ALI 





BUM 


null, 








D; L 





ST POS) ) ; 








te table ARTI 








as identity (s 


actualArtist i 





primary key (ART 





default 





tart with 1), NAME 
nteger, 








ST 








[hibernatetool]create table TRACK (TI] 





table ALBUM COMM 


] create table ALBUM (ALBUM _ 


[STS (ART 





BUM TRACKS (ALBUM _ 


TRACK 


[ST (ART 


ENTS (ALBUM 





tity (start with 1), added date, numDiscs integer, 














ST ID integer not 








ID integer not 











ID integer not 








ID integer, 














ST ID integer generated by 





varchar (255) not null, 





D) , unique (NAME) ) ; 











RACK _ 


as identity (start with 1), added date, 








ID integer generated by 











TLE 





filePath varchar (255) not null, playTime time, 


sourceMedia varchar (255), T varchar (255) not null, 





VOL LEFT smallint, VOL RIGHT smallint, 





primary key (TRACK _ 
[hibernatetool]crea 





null, 
TRACK ID 








null, 





integer not 
primary key (TRACK I 
[hibernatetool]crea 








ID) ); 











Ce 





table TRACK ARTI 


null, 
ART 





D) ) ; 





ST 














COMMENT varchar (255) ) ; 





[hiberna 
[hiberna 


Le 
Le 














too] 


tool]create index Al 


table TRACK COMM 


[STS (ART 





ENTS (TRACK _ 








BUM T 


TLE 





G 























ST ID integer not 








ID integer not 





on ALBUM (TITLE) ; 














Jalter table ALBUM ARTISTS add constraint 





FK7 








BA403FCB99A6003 





fore 




















ign key (ARTIST ID) references ALBUM; 

[hibernatetool]Jalter table TRACK COMMENTS add constraint 

FK105B2688E424525B for 

eign key (TRACK ID) references TRACK; 

[hibernatetool]9 errors occurred while performing<hbm2dd1>.@ 

[hibernatetool]Error#1: java.sql.SQLException: Table not found: 

ALBUM ARTISTS 
in statement[alter table ALBUM ARTISTS] 

























































































BUILD SUCCESSFUL 
Total time: 5 seconds 























人 O@O 因 为 这 是 我 们 第 一 次 要 求 Maven Ant Tools#é (Hibernate 
Annotations， 它 们 将 作为 依赖 而 自动 下 载 。 


这 里 你 可 以 看 到 ， 正 在 使 用 标注 来 驱动 数据 库 模 式 的 创建 。 


全 如 果 同 例 5-7 中 的 相应 行进 行 比较 ， 你 会 发 现 虽 然 显 示 的 顺序 不 
同 ， 但 列 定义 是 完全 一 样 的 。ALBUM_ARTISTS、 
ALBUM_COMMENTS 以 及 最 具 挑 战 性 的 ALBUM_TRACKS 的 定义 都 是 
同样 的 情况 。 我 们 已 经 成 功 地 用 标注 再 次 创建 了 原来 的 数据 库 模 式 。 











@@ 在 创建 数据 库 模式 ， 当 运行 时 根本 不 存在 数据 库 时 ， 就 会 看 到 这 
些 普通 的 错误 信息 。 这 些 错误 不 会 中 止 创建 过 程 ， 虽 然 有 错误 ， 但 可 以 
认为 创建 过 程 还 是 成 功 的 。 











同时 ， 你 可 以 在 本 章 目 录 下 运行 ant db 命令 ， 就 像 第 5 章 做 的 那样 ， 
并 比较 一 下 它们 各 自生 成 的 数据 库 模 式 。 当 然 ， 看 看 实际 的 数据 ， 效 果 
应 该 更 好 。 为 了 让 CreateTest.java 可 以 处 理 基 于 标注 的 映射 ， 需 要 修改 


它 的 两 个 地 方 ， 如 例 7-10 所 示 。 我 们 需要 导入 Annotation-Configuration 
类 ， 并 在 以 前 使 用 Configuration 类 的 位 置 使 用 它 。 





例 7-10: 对 测试 类 进行 调整 ， 以 处 理 基于 标注 的 映射 





package com.oreilly.hh; 

import org.hibernate.*; 

import org.hibernate.cfg.AnnotationConfiguration; 
import org.hibernate.cfg.Configuration; 
































public static void main (String args[]) throws Exception { 
//Create a configuration based on the annotations in our 
//model classes. 
Configuration config=new AnnotationConfiguration () ; 
config.configure () ; 





























修改 完 后 ， 运 行 ant ctest 命 令 就 可 以 创建 示例 数据 ， 并 使 用 多 个 ant 
db 的 实例 ， 依 次 对 数据 进行 比较 。 


对 QueryTest.java、QueryTest2.java 以 及 AlbumTest.java 进 行 同样 的 修 
改 。 因 为 运行 ant qtest 和 ant qtest2 命 令 的 输出 与 前 一 章 相 同 ， 这 里 就 不 
再 演示 了 。 但 是 我 们 想 演 示 来 自 AlbumTest 的 输出 内 容 ， 因 为 它 需 要 依 
赖 整个 数据 库 模 式 ， 所 以 可 以 作为 一 个 不 错 的 完整 性 检查 。 用 它 也 可 以 
验证 例 7-8 后 面 介绍 的 那 行 用 于 保存 曲目 的 代码 确实 被 取消 注释 了 。 运 
行 ant atest， 对 我 们 这 个 基于 标注 的 数据 库 模式 进行 测试 的 结果 如 例 7-11 
所 示 。 











例 7-11: 运行 AlbumTest， 测 试 标注 的 使 用 


TS | 


atest: 

[java]com.oreilly.hh.data.Album@27d19d[title='Counterfeit 
e.p.'tracks='[ 

com.oreilly.hh.data.AlbumTrack@bf4c80[track='com.oreilly.hh.data.T 

title='Compulsion'volume='Volume[left=100, 
right=100]'sourceMedia='CD']'], c 

om.oreilly.hh.data.AlbumTrack@3778cf[track='com.oreilly.hh.data.Tr 

itle='In a Manner of Speaking'volume='Volume[left=100, 
right=100] 'sourceMedia= 

'CD'J'], 
com.oreilly.hh.data.AlbumTrack@dc696e[track='com.oreilly.hh.data.Tra 

ck@a5dacO[title='Smile in the Crowd'volume='Volume[left=100, 
right=100] 'sourc 

eMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@8dbefl[track='com.oreilly.hh.d 

ata.Track@c4b579[title='Gone'volume='Volume[left=100, 
right=100] 'sourceMedia= 

ICD] Ja 
com.oreilly.hh.data.AlbumTrack@f2f761[track='com.oreilly.hh.data.Tra 

ck@8cd64[title='Never Turn Your Back on Mother 
Earth'volume='Volume[left=100, 

right=100] 'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@4f1541 [track= 

"com.oreilly.hh.data.Track@c042ba[title='Motherless 
Child'volume='Volume[left= 

100, right=100] 'sourceMedia='CD']'J]'] 








































































































除了 Java 随 机 将 类 加 载 到 的 内 存 地 址 不 同 以 外 ， 例 7-11 与 例 5-10 中 
看 到 的 输出 完全 相同 ， 和 我 们 希望 的 一 样 。 


注意 : 这 种 方法 能 行 ! 真 的 能 行 ! 


四 “如 果 你 跳 过 本 书 前 面 的 内 容 直 接 阅读 这 一 章 ， 那 么 最 好 回去 再 了 解 
一 下 用 到 的 这 些 类 和 它们 之 间 的 关系 ， 至 少 要 浏览 一 下 从 第 3 章 开始 的 
内 容 ， 再 继续 学 习 。 这 样 你 的 收获 可 能 更 多 。 


[2] http://java.sun.com/javaee/technologies/persistence.jsp. 


[3] 变量 buildet 是 方法 的 局 部 变量 、 
变量， 所 以 不 可 能 会 有 多 个 线程 同时 使 用 这 
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为 一 种 方法 


这 个 试验 表明 标注 确实 是 一 种 映射 模型 类 的 可 行 方法 。 通 过 为 数 不 
多 的 几 步 ， 我 们 束 可 以 精确 地 维护 前 面 章 节 中 逐步 建立 的 数据 库 模 式 ， 
只 是 标注 这 种 方法 不 能 让 我 们 在 创建 Album 时 级 联 创建 Track 对 象 。 如 果 
以 稍微 不 同 的 方式 来 考虑 AlbumTrack 类 ， 则 还 有 另 一 种 方法 ， 让 我 们 在 
数据 库 模式 中 能 够 维护 这 种 自动 的 级 联 处 理 ， 同 时 也 提供 了 一 些 其 他 功 


au 
HE o 





将 AlbumTrack 了 映射 为 一 个 完整 的 实体 ， 我 们 就 可 以 添加 级 联 标注 ， 
Hibernate 就 会 优先 处 理 Album 定 义 ， 以 嵌入 对 Track 的 引用 。 这 也 给 我 们 
带 来 一 些 新 的 需要 考虑 的 复杂 问题 ， 但 其 中 一 部 分 需要 视 不 同 的 时 机 而 
定夺 。 首 先 ， 将 AlbumTrack 作 为 实体 就 需要 具有 ID。 同 时 ， 因 为 我 们 接 
着 需要 不 从 Album 开 始 就 可 以 处 理 AlbumTrack 对 象 ， 所 以 应 该 扩充 
AlbumTrack 模 型 ， 以 提供 从 ALBUM_TRACKS 表 返回 到 ALBUM 表 的 链 
fe (PANT EP Hibernate GE) 。 为 此 ， 需 要 增加 一 个 album 属 
性 。 例 7-12 演 示 了 AlbumTrack 映 射 中 关键 的 一 部 分 ， 也 是 这 种 方法 的 独 
特 之 处 所 在 。 








例 7-12: 将 AlbumTrack 类 标注 为 实体 





package com.oreilly.hh.data; 
import java.io.Serializable; 





import 
Entit 
Table (n 
ublic cl 


Id@ 








QT ef ® 





t javax.persistence.*; 
ty@ 





ame="ALBUM TRACKS") 
lass AlbumTrack{ 


@GeneratedValue (strategy=GenerationType.AUTO) 





private 





Integer id; 
@ManyToOne 
@JoinColumn (name="ALI 
nullable= 


false, © 











ID", insertable=t 





BUM _ false, updatable={ 





false) 





private Album albun; 
@ManyToOne (cascade=CascadeType.ALL) @ 


@JoinCol 
private 


public 





lumn (name="TRACK _ 
Track track; 


Integer get] 


ID", nullable=false) 








[Id ©) { 





return id; 


} 


public void set 





d ¢ 











nteger id) { 


this.id=id; 


} 
public Al 


lbum getAlbum () { 





return al 
} 
© 


lbum; 


public Track getTrack () { 





各 明显 地 ， 我 们 将 类 标注 由 @Embeddable 修 改 为 @Entity， 而 且 就 


在 这 里 选择 了 表 名 ， 而 不 是 在 Album 类 的 源 文件 中 。 





介 此 处 与 基于 XML 的 例子 中 的 模式 差别 最 大 。 以 前 我 们 的 





ALBUM_TRACK 表 使 用 一 个 复合 主键 ， 利 用 的 是 ALBUM_ID 和 
TRACK_ID 的 一 个 特定 组 合 在 数据 库 中 只 有 一 个 记录 这 一 事实 ， 这 样 就 
节省 了 我 们 在 ALBUM_TRACK 表 中 提供 一 个 单独 的 ID 列 的 需要 。 





虽然 让 AlbumTrack 成 为 一 个 实体 后 还 保留 原来 的 数据 库 模 式 也 是 可 


能 的 ， 不 过 这 需要 付出 不 少 的 努力 。JPA 要 求 所 有 的 复合 主键 都 要 被 映 
射 为 一 个 单独 的 类 ， 由 这 个 类 来 提供 一 个 主键 的 各 个 成 员 。 所 以 ， 为 了 
保留 原来 我 们 的 数据 库 模 式 ， 就 必须 对 模型 类 进行 比较 大 的 修改 ， 只 是 
为 了 持 有 AlbumTrack 类 的 主键 而 创建 一 个 新 的 类 。 


相反 ， 也 可 以 稍微 修改 一 下 数据 库 模 式 ， 为 ALBUM_TRACKS 增 加 
一 个 ID 列 〈 应 该 承认 ， 这 个 列 没有 什么 实际 用 途 ) ， 看 起 来 是 一 种 破坏 
力 比较 小 的 选择 。 无 论 如 何 ， 当 改变 映射 方法 时 ， 我 们 将 要 面 对 各 种 权 
衡 ， 这 个 例子 就 是 一 个 有 趣 的 演示 。 


全 到 Album 的 映射 是 我 们 以 前 见 过 的 @ManyToOne， 但 是 还 需要 提 
供 一 些 额 外 的 参数 ， 才 能 让 它 按 我 们 想 要 的 方式 来 工作 。 这 上 段 “ 完 语 * 用 
于 重新 创建 我 们 曾经 用 Album.hbm.xml 取 得 的 映射 效果 ， 让 Hibernate 完 
全 控制 对 ALBUM_TRACKS 表 的 ALBUM_ID 列 的 维护 。 如 果 没 有 
@JoinColumn 标 注 中 的 insertable 和 updatable 属 性 ， 我 们 就 得 必须 修改 
AlbumTest， 为 每 个 AlbumTrack 对 象 显 式 地 设置 abum 属 性 ， 这 样 也 就 意 
味 着 失去 了 一 些 我 们 想 要 从 Hibernate 得 到 的 自动 处 理 。 


当 使 用 实体 上 的 索引 映射 时 (具有 @IndexColumn 或 @MapKey) ， 
你 应 该 记 住 这 种 应 用 模式 。 


人 既然 AlbumTrack 是 一 个 实体 ，Hibernate 就 能 够 为 它 的 track 属 性 应 
用 cascade 的 设置 。 


全 我 们 可 以 强化 一 个 概念 ，Hibernate 在 管理 到 专辑 的 链接 Calbum 
属性 ) 时 ， 并 没有 使 用 setAlbum O 方法 。 


当然 ， 在 Album.java 中 这 一 关系 的 映射 方式 也 会 有 稍微 的 不 同 ， 如 


例 7-13 所 示 。 


例 7-13: Album.java 中 的 AlbumTracks 实 体 映 射 


@OneToMany (cascade=CascadeType.ALL) 
@IndexColumn (name="LIST POS") 

@JoinColumn (name="ALBUM ID", nullable=false) 
private List<AlbumTrack>tracks; 























@OneToMany 标 注 中 的 级 联 (cascade) WE, CW Album PikA 
的 Track 引用 来 建立 这 种 完整 的 级 联 关 系 ， 我 们 在 例 5-13 开 发 的 
Album.hbm.xml 最 终 版 本 中 也 曾经 建立 过 这 样 的 关联 ， 在 那个 例子 中 是 
由 专辑 对 象 来 管理 它们 的 曲目 对 象 的 生命 周期 。 在 这 里 ， 需 要 再 一 次 将 
AlbumTest 的 addAlbumTrack《〈) 方法 中 用 于 保存 曲目 的 那 行 代 码 注释 
掉 。 这 样 ， 我 们 用 不 同 的 数据 库 模 式 重新 创建 了 原来 的 功能 。 如 果 不 怕 
麻烦 ， 也 可 以 创建 一 个 类 来 负责 管理 复合 键 ， 这 样 就 可 以 保留 原来 的 功 
能 和 数据 库 模 式 。 














和 许多 其 他 Hibernate API《〈 以 及 一 般 的 面 癌 对 象 的 建 模 方法 ) 一 
样 ， 可 以 用 多 种 方法 来 实现 一 个 功能 。 


现在 怎么 办 


希望 这 一 章 可 以 让 你 对 如 何 用 标注 来 表达 数据 映 映 有 个 大 致 的 了 
解 ， 也 希望 当 你 为 自己 的 项 目 探索 新 的 选择 时 ， 本 章 介 绍 的 内 容 可 以 作 
为 一 个 恨 好 的 起 点 。 在 本 书 接 下 来 的 部 分 ， 我 们 将 不 列举 相关 技术 的 所 
有 细节 和 功能 《这 应 该 是 Hibernate 参 考 手册 的 任务 ) ， 虽 然 有 时 介绍 的 
比较 肤浅 ， 但 希望 我 们 讨论 的 一 些 问 题 可 以 作为 帮助 你 解决 模糊 问题 的 
示例 。 如 果 所 有 办 法 部 解决 不 了 问题 ， 那 只 能 党 试 让 问题 重新 出 现 ， 再 
将 错误 消息 粘贴 到 Google 上 搜索 ! 或 者 ， 如 果 你 是 好 “公民 ”的 话 ， 可 以 
研究 一 下 源 代 码 ， 将 问题 发 布 到 Hibernate 论 坛 上 以 寻求 帮助 ， 把 解决 问 
题 的 希望 留 给 未 来 的 用 户 ， 并 帮助 突出 应 该 加 强 Hibernate 文 档 的 哪些 前 


Te 


在 接 下 来 的 几 章 中 ， 我 们 将 继续 回 到 基于 XML 的 世界 ， 看 看 几 种 


得 询 数据 的 方法 。 但 是 ， 还 应 该 记 住 标注 的 概念 ， 在 本 书 结尾 部 分 介绍 
Spring 和 Stripes 的 章节 中 ， 将 会 再 次 用 到 它们 。 








Fem KFAR 





像 HQL 〈 以 及 作为 它 的 基础 的 SQL ) 这 样 的 关系 型 查询 语言 都 非常 
灵活 而 且 功 能 强大 ， 但 是 如 果 要 真正 精通 ， 也 得 花费 很 长 的 时 间 。 很 多 
应 用 程序 开发 人 员 对 SQL 只 有 基本 的 了 解 ， 只 能 根据 以 往 的 项 目 模仿 些 
相似 的 示例 ， 当 磁 上 真正 没有 遇 到 过 的 或 是 非常 难以 理解 的 查询 表达 式 
If, Aree POR BEER ARAN FH. </p> 











将 碍 询 语言 的 语法 和 Java 代 码 混杂 在 一 起 ， 也 很 及 烦 。 第 3.4 节 介绍 
了 一 种 将 所 有 得 询 语句 单独 放 在 另 一 个 文件 中 ， 可 以 集中 对 它们 进行 碍 
看 和 编辑 ， 不 需要 使 用 Java 字 符 串 转 义 字符 序列 Cescape sequence) 和 
串联 (concatenation) 语 法。 不 过 ， 即 使 采用 这 种 技巧 ， 也 是 直到 加 载 
映射 文档 时 才 会 解 机 HQL 碍 询 语句 ， 也 就 是 次，HQL 碍 询 内 容 中 隐藏 的 
语法 错误 在 应 用 程序 运行 以 前 都 无 法 捕获 。 











Hibernate 玉 用 条 件 查 询 的 方法 ， 为 这 些 问题 提供 了 一 种 不 同 寻 常 的 
解决 方案 。 这 种 方法 通过 创建 简单 的 Java 对 象 ， 并 把 它们 串 连 起 来 ， 将 
其 作为 过 滤 圳 来 中选 出 你 想 要 的 结果 。 你 可 以 建立 藤 套 的 、 结 构 化 的 表 
达 式 。 这 种 机 制 也 可 以 让 你 只 提供 示例 对 象 ， 以 表明 你 想 碍 找 的 内 容 是 
十 么 ， 同 时 还 能 控制 哪些 细节 需要 关注 、 哪 些 属 性 可 以 忽略 。 


= 


从 后 面 的 介绍 中 可 以 看 到 ， 这 种 功能 非常 方 便 。 但 是 坦率 地 讲 ， 它 





也 有 自身 的 (非常 次 要 的 ) 缺点 。 把 元 长 的 查询 表达 式 转 换 成 Java API 
会 占用 更 多 的 内 存 空 间 ， 对 于 经 验 丰富 的 数据 库 开 发 人 员 而 言 ， 他 们 对 
条 件 查 询 不 像 对 类 SQL (SQL-like) 查询 语言 那么 熟悉 。 有 些 东 西 你 无 
法 用 以 前 的 条 件 查询 API 来 加 以 表达 ， 诸 如 投影 “从 一 个 类 的 多 个 属性 
中 取出 子 集 ， 例 如 "select title, id from com.oreilly.hh.Track"， 而 不 








是 "select*from com.oreilly.hh.Track") MRE (aggregation) (对 查询 结 
果 做 统计 总 结 ， 例 如 获取 某 个 属性 的 总 和 、 平 均值 以 及 总 数 ) 。 这 种 非 
常 严重 的 不 足 ， 在 编写 本 书 第 1 版 时 API 就 存在 ， 不 过 ， 在 Hibernate 3 中 
已 经 得 到 了 解决 。 我 们 会 向 你 介绍 现在 应 该 怎么 实现 这 些 条 件 查 询 。 下 
章 还 会 演示 如 何 使 用 Hibernate 的 面向 对 象 的 查询 语言 HL) 来 完成 
此 类 任务 。 











不 论 使 用 哪 一 种 Hibernate 的 方法 来 表达 查询 ， 最 终 都 会 生成 特定 数 
据 库 的 SQL 语句 ， 由 SQL 来 实现 查询 目的 。 所 幸 ， 你 不 会 看 到 这 些 底层 
细节 ， 但 是 ， 如 果 你 对 这 些 细节 感 兴趣 的 话 ， 可 以 使 用 Hibernate 配 置 文 
件 的 show_sql 属 性 打开 SQL 日 志 输 出 《如 例 3-1 所 示 ) ， 或 是 在 Eclipse 中 
使 用 交互 式 的 SQL 查询 预览 〈 将 在 第 11 章 介绍 ) 。 








使 用 简单 条 件 碍 询 





我 们 先 建 一 个 条 件 查 询 来 查找 播放 时 间 少 于 指定 长 度 的 曲目 ， 将 例 
3-11 中 所 用 的 HQL 蔡 换 挥 ， 并 更 新 例 3-12 的 代码 。 


应 该 怎么 做 





需要 明白 的 第 一 件 事 就 是 如 何 指定 我 们 想 要 检索 的 对 象 的 类 型 。 在 
建立 条 件 查 询 时 ， 不 会 涉及 任何 查询 语言 。 相 反 ， 你 得 构建 一 个 由 
Criteria 对 象 组 成 的 树 状 结构 来 描述 你 需要 检索 的 对 象 。Hibernate 
Session 就 是 创建 这 些 Criteria 对 象 的 工厂 ， 而 你 需要 做 的 就 是 指定 想 要 检 
索 到 的 对 象 的 类 型 ， 够 方便 的 吧 。 











编辑 QueryTest,jjava， 将 tracksNoLongerThan O 方法 的 内 容 蔡 换 成 
例 8-1 所 示 的 内 容 。 


注意 : 这 些 示例 假设 已 经 按照 前 儿 半 所 述 建 并 好 了 数据 库 。 如 果 你 
不 想 从 头 开始 ， 就 下 载 示 例 代码 ， 然 后 再 跳 到 这 一 章 的 目录 ， 运 行 
codegen、schema、 以 及 ctest 这 几 个 构建 目标 。 即 使 你 按照 书 中 介绍 一 路 
走 来 ， 运 行 schema 和 ctest 也 将 确保 生成 这 些 示 例 展示 的 数据 。 








例 8-1: 条 件 碍 询 入 门 





public static List tracksNoLongerThan (Time length, Session 
session) { 

Criteria criteria=session.createCriteria (Track.class) ; 

return criteria.list © ; 


} 











会 话 对 象 的 createCriteria O 方法 会 创建 一 个 条 件 查 询 对 象 
(Criteria 类 的 实例 ) ， 由 它 返 回 作为 参数 传递 给 它 的 持久 化 类 的 所 有 实 


例 ， 真 够 简单 的 。 当 然 ， 如 果 现 在 运行 示例 ， 会 看 到 数据 库 中 保存 的 所 
有 曲目 ， 因 为 我 们 还 没有 使 用 任何 查询 条 件 〈criteria) 来 限制 查询 结果 
(如 例 8-2 所 示 ) 。 





例 8-2: 羽 中 未 丰 的 条 件 查 询 将 返回 所 有 曲目 





Sant qtest 





[java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 
[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 











49, 

from VHS Videocassette tape 

[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact 

Disc 








[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 
William Orbit, Samuel Barber) 00: 06: 35, from Compact Disc 
[java]Track: "Adagio for Strings (ATB Remix) " (William Orbit, 





























ATB, 
Samuel Barber) 00: 07: 39, from Compact Disc 
[java]Track: "The World'99" (Ferry Corsten, Pulp Victim) 00: 07: 














05, 
from Digital Audio Stream 

[java]Track: "Test Tone 1"00: 00: 10 
[java]Comment: Pink noise to test equalization 














好 ， 够 简单 。 那 么 ， 应 该 怎么 挑选 出 我 们 想 要 的 曲目 ? 也 很 简单 ! 
只 要 在 源 文件 顶端 新 增加 一 行 : 











import org.hibernate.criterion.*; 








然后 ， 再 在 这 个 方法 中 新 增加 一 行 ， 如 例 8-3 所 示 。 


例 8-3: 用 Criteria 碍 询 完 全 取代 第 3 草 使 用 的 HQL 碍 询 





public static List tracksNoLongerThan (Time length, Session 
session) { 

Criteria criteria=session.createCriteria (Track.class) ; 

criteria.add (Restrictions.le ("playTime", length) ) ; 

return criverta list () 4 


} 























注意 : 束 像 HQL 那 样 ， 表 达 式 总 是 以 对 象 属性 来 表示 ， 而 不 使 用 数 
据 表 的 字段 。 





Restrictions 类 是 一 个 工厂 类 ， 用 于 获取 在 查询 中 指定 各 种 约束 条 件 
的 Criterion 实 例 。 它 的 le O 方法 会 创建 一 个 Criterion 对 象 ， 限 制 一 个 属 
性 必须 小 于 或 等 于 指定 的 值 。 在 这 个 例子 中 ， 我 们 想 让 Track 的 playTime 
属性 不 大 于 传递 给 该 方法 的 值 。 最 后 再 把 它 添加 到 所 要 的 条 件 碍 询 组 合 
中 。 下 一 节 我 们 将 会 看 到 其 他 几 个 通过 Restrictions 能 用 的 Criterion 类 
型 。 附 录 B 会 列 出 全 部 的 Criterion 类 型 ， 如 果 你 想 支 持 新 的 条 件 形式 ， 
也 可 以 自行 创建 Criterion 接 口 的 实现 。 








次 运行 查询 时 ， 会 得 到 长 度 不 超过 7 分 钟 的 曲目 ， 如 例 8-4 所 示 。 


例 8-4: 完整 的 简单 条 件 查 询 的 结果 





Sant qtest 

qtest: 

[java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 

[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 
49, 








from VHS Videocassette tape 

[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact Disc 

[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 
Samuel Barber, William Orbit) 00: 06: 35, from Compact Disc 
ava]Track: "Test Tone 1"00: 00: 10 

ava]Comment: Pink noise to test equalization 
































oe ds 





注意 : 本 书 新 版 修订 了 这 个 示例 ，"Adagio for Strings" 会 在 iTunes 中 
随机 开始 播放 。 





在 实际 应 用 中 ， 绝 大 多 数 用 于 检索 对 象 的 查询 都 是 非常 简单 的 ， 而 
条 件 查 询 更 是 用 Java 表 达 这 些 查询 时 极为 自然 和 简洁 的 方式 。 新 的 
tracksNoLongerThan O 方法 实际 上 比例 3-12 和 那个 需要 将 查询 添加 到 
映射 文件 的 示例 〈 例 3-11) 还 要 短 ! 不 过 ， 它 们 最 终 都 以 相同 的 模式 来 
访问 底层 数据 库 ， 所 以 运行 效率 相当 。 





Nit, WARRANT, thay DNS eA Be. Add O 和 
createCriteria O 方法 会 返回 Criteria 实 例 ， 所 以 可 以 在 同一 Java 语 句 中 
连续 操作 该 实例 。 利 用 这 一 点 ， 我 们 就 能 把 这 个 方法 再 归纳 一 下 ， 变 成 
例 8-5 的 样子 。 


例 8-5: 更 为 紧凑 的 条 件 碍 询 





public static List tracksNoLongerThan (Time length, Session 
session) { 

return session.createCriteria (Track.class) . 

add (Restrictions.le ("playTime", length) ) .list © ; 

} 


= 








选择 编码 风格 就 是 在 空间 和 可 读 性 之 间 做 出 取舍 不过， 有 些 人 会 
党 得 这 种 紧凑 、 连 续 纺 码 的 版 本 更 具 可 该 性 ) 。 


其 他 


对 结果 进行 排序 ?从 所 有 匹配 的 对 象 中 取 回 它们 的 一 部 分 ?和 
Query 接 口 一 样 ，Criteria 接 口 也 可 以 让 你 调用 setMaxResults O) 和 
setFirstResult () 方法 来 限制 取 回 的 结果 数目 (以 及 选择 从 哪里 开 
始 ) 。 此 外 ， 这 个 接口 也 可 以 让 你 控制 结果 返回 的 顺序 (在 HQL 查 询 
中 ， 则 是 使 用 order by 子 句 〉)， 如 例 8-6 所 示 。 


例 8-6: 按照 标题 对 结果 进行 排序 





public static List tracksNoLongerThan (Time length, Session 
session) { 

Criteria criteria=session.createCriteria (Track.class) ; 

criteria.add (Restrictions.le ("playTime", length) ) ; 

criteria.addOrder (Order.asc ("title") .ignoreCase () ); 

return criteria. list ©) ; 


} 




















Order 类 只 是 表达 排列 顺序 的 一 种 方式 。 它 有 两 个 静态 的 工厂 方 
法 : asc O 和 desc《〈) 方法 ， 分 别 用 于 创建 升序 和 降序 的 排列 。 每 个 方 
法 都 以 要 排序 的 属性 名 称 作为 参数 。 如 果 调 用 Order 实 例 的 
ignoreCase O 方法 ， 则 排序 将 不 区 分 字母 的 大 小 写 ， 这 经 第 是 你 想 要 
的 显示 方式 。 运 行 这 个 版 本 的 示例 ， 其 结果 如 例 8-7 所 示 。 


例 8-7: 对 检索 结果 进行 排序 





Sant qtest 





[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 

Samuel Barber, William Orbit) 00: 06: 35, from Compact Disc 
[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 

















Compact 
Disc 
[java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 
ava]Track: "Test Tone 1"00: 00: 10 

ava]Comment: Pink noise to test equalization 

ava]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 
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49, 





from VHS Videocassette tape 





可 以 在 Criteria 添 加 多 个 Order， 这 样 Criteria 就 会 按 每 个 Order 的 先后 
进行 排序 〈 先 按 第 一 个 Order 排 序 ， 如 果 有 任何 查询 结果 与 那个 属性 具 
有 相同 的 值 ， 就 再 按 第 二 个 Order 进 行 排序 ， 依 此 类 推 ) 。 


ZH LAR Ea 


可 以 想到 ， 如 果 在 查询 中 添加 多 个 Criterion， 那 么 结果 中 的 对 象 束 
得 满足 所 有 的 Criterion。 这 相当 于 使 用 Restrictions.conjunction O 建立 
一 个 组 合 条 件 ， 详 情 可 以 参阅 附录 B。 就 例 8-8 来 说 ， 我 们 可 以 限制 查询 
结果 ， 所 以 在 该 方法 中 另 加 一 行 ， 使 得 曲目 的 标题 中 必须 包含 字 
BRA". 


例 8-8: “MEDI NARA 





Criteria criteria=session.createCriteria (Track.class) ; 
criteria.add (Restrictions.le ("playTime", length) ) ; 





























criteria.add (Restrictions.like ("title", "SA%") ) ; 
criteria.addOrder (Order.asc ("title") .ignoreCase () ) ; 
return criteria.list () ; 




















准备 好 以 后 ， 运 行程 序 ， 这 次 会 得 到 较 少 的 结果 ， 如 例 8-9 所 示 。 


例 8-9: 播放 时 间 等 于 或 少 于 7 分 钟 且 标题 包含 字母 "A" 的 曲目 





qtest: 

[java] Track: "Adagio for Strings (Ferry Corsten Remix) " (Samuel 
Barber, 

Ferry Corsten, William Orbit) 00: 06: 35, from Compact Disc 

[java] Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 

Compact Disc 




















ee | 


如 果 你 不 记得 (或 不 知道 ) 像 这 样 的 SQL“%” 字 符 串 匹配 的 语法 ， 
Hibernate 还 提供 了 一 个 可 供 调 用 的 参数 变量 ， 用 于 在 Java 中 表达 你 需要 
的 任何 匹配 。 就 这 个 例子 来 说 ， 可 以 写成 
Restrictions.like ("title", "A", MatchMode.ANYWHERE) 。 如 果 你 想 
进行 区 分 大 小 写 的 匹配 ， 应 该 使 用 让 ke， 而 不 是 like。 


如 果 你 希望 找 出 满足 任意 条 件 之 一 的 对 象 ， 而 非 满 足 所 有 条 件 的 对 
象 ， 就 得 显 式 的 使 用 Restrictions.disjunction O 将 这 些 条 件 分 组 。 可 以 
使 用 Restrictions 类 提供 的 Criteria 工 厂 来 建立 这 些 分 组 以 及 其 他 复杂 层次 
的 组 合 。 详 情 可 以 参阅 附录 B。 例 8-10 演 示 了 我 们 对 示例 查询 的 修改 ， 
让 返回 的 曲目 既 满足 时 间 长 度 限 制 又 满足 标题 包含 大 写字 母 A。 














注意 : 条 件 碍 询 结合 了 强大 的 功能 和 方便 性 ， 令 人 吃惊。 





例 8-10: 限制 较 宽松 的 条 件 查 询 





Criteria criteria=session.createCriteria (Track.class) ; 
Disjunction any=Restrictions.disjunction () ; 

any.add (Restrictions.le ("playTime", length) ) ; 

any add: (Restrictions.like ("title", "%A%") ) ; 
criteria.add (any) ; 
criteria.addOrder (Order.asc ("title") .ignoreCase () ) ; 
return criteria llist. () ; 















































这 会 让 我 们 多 获取 一 个 新 的 "Adagio for Strings" 曲 目 《 如 例 8-11 所 


E 


例 8-11: 标题 含有 字母 "A" 或 者 时 间 不 超过 7 分 钟 的 曲目 





qtest: 

[java]Track: "Adagio for Strings (ATB Remix) " (ATB, William 
Orbit, 

Samuel Barber) 00: 07: 39, from Compact Disc 

[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 

William Orbit, Samuel Barber) 00: 06: 35, from Compact Disc 

[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 












































Compact 
Disc 
java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 
java]Track: "Test Tone 1"00: 00: 10 
java]Comment: Pink noise to test equalization 
java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 





49, 





from VHS Videocassette Tape 





最 后 要 注意 的 是 ， 把 这 个 方法 精简 到 一 个 表达 式 也 是 可 行 的 (如 例 
8-12 所 示 ) 。 这 得 多 亏 这 些 方法 的 设计 精巧 的 返回 值 。 


例 8-12: 代码 精简 得 有 些 过 头 





return 
session.createCriteria (Track.class) .add (Restrictions.disjunction () 
add (Restrictions.le ("playTime", length) ) . 
add (Restrictions.like ("title", "SA%") ) ) . 
addOrder (Order .asc ("title") .ignoreCase ©) ) .list O ; 



































里 然 得 到 的 结果 都 一 样 ， 但 我 觉得 你 也 会 认为 这 样 做 对 该 方法 代码 
的 可 读 性 没有 什么 帮助 (可 能 LISP 专 家 不 算 在 内 吧 〉! 





可 以 用 Restrictions 提 供 的 工具 来 建立 各 种 各 样 的 多 重 条 件 。 有 些 情 


况 还 得 需要 HQL， 而 且 超 过 一 定 的 复杂 度 的 话 ， 可 能 还 是 用 HQL 比 较 
好 。 但 是 ， 条 件 查 询 能 够 让 你 做 很 多 事情 ， 这 常常 是 正确 的 做 法 。 





BURA AE GHAR TEE 


如 果 你 对 SQL 比较 熟悉 ， 那 么 应 该 明白 本 节 标 题 的 意思 。 如 宋 不 明 
日 的 话 ， 也 不 要 担心 ， 它 们 其 实 相 当 人 简单。 投影 只 是 说 ， 你 并 不 是 需要 
一 个 表 中 的 所 有 信息 ， 而 是 只 需要 其 中 的 一 部 分 。 在 像 Hibernate 这 样 的 
面 问 对 象 的 环境 中 ， 投 影 就 是 指 不 必 检 索 回 一 个 完整 的 对 象 ， 只 需要 对 
象 的 一 两 个 属性 。 聚 合 就 是 标识 一 些 属 性 ， 并 计算 针对 这 些 属 性 的 统计 
言 轧 ， 例 如 计算 总 和 、 最 大 值 、 节 小 值 以 及 平均 值 。 








在 Hibernate 3 以 前 ， 不 使 用 HQL 就 没 办 法 进行 这 样 的 操作 ， 所 以 这 
是 Hibernate 3 对 Criteria API 的 一 个 很 好 的 扩展 。 我 们 先 来 看 看 一 些 示 
例 。 先 来 个 简单 的 例子 ， 假 设 我 们 想 打 印 所 有 标题 包含 字母 "v" 的 曲目 
的 标题 ， 但 不 必 加 载 任何 一 个 完整 的 Track 对 象 。 





应 该 怎么 做 


例 8-13 演 示 了 一 个 方法 ， 它 使 用 Criteria API 提 供 的 投影 功能 来 实现 
一 目的 。 


例 8-13: 对 单一 属性 的 简单 投影 





/** 


*Retrieve the titles of any tracks that contain a particular text 





string. 
大 





*@param text the text to be matched, ignoring case, anywhere in 
the title. 
*@param session the Hibernate session that can retrieve data. 
*@return the matching titles, as strings. 
weg 
public static List titlesContainingText (String text, Session 
session) { 
Criteria criteria=session.createCriteria (Track.class) ; 
criteria.add (Restrictions.like ("title", text, 
MatchMode.ANYWHERE) .@ 
ignoreCase () ) ; 
criteria.setProjection (Projections.property ("title") ); © 
return criteria.list () ; 


} 









































各 这 行 演示 了 使 用 MatchMode 接 口 来 避免 执行 字符 串 处 理 ， 也 不 用 
为 了 指定 想 要 的 字符 串 匹 配 模 式 而 记 住 特定 的 “9%"? 字 符 的 用 法 。 





四 这 里 使 用 Projections 类 来 告诉 criteria， 我 们 想 要 进行 一 个 投影 操 


作 ， 我 们 对 取 回 找到 的 曲目 的 tile 属 性 特别 感 兴趣 。 


像 我 们 的 其 他 条 件 查 询 一 样 ， 这 个 方法 返回 的 也 是 一 个 List 对 象 。 
但 是 确切 地 说 ， 到 底 是 什么 内 容 的 列表 呢 ?Criteria 是 在 Track 类 的 基础 
上 创建 的 ， 但 是 由 于 我 们 只 需要 检索 回 曲目 的 标题 属性 ， 所 以 构造 并 返 
回 整 个 Track 对 象 并 没有 多 大 意义 。 事 实 上 ， 在 这 种 情况 下 ， 只 要 将 整 
个 对 象 投影 到 一 个 属性 ， 就 可 以 得 到 与 该 属性 相关 联 的 类 型 的 一 个 列 
表 。 在 这 个 例子 中 ， 因 为 它 是 一 个 字符 串 属性 ， 所 以 得 到 的 就 是 一 个 包 
含 String 实 例 的 List 对 象 。 








注意 : 这 样 做 确实 有 意义 ! 


为 了 检验 效果 ， 可 以 将 这 个 方法 添加 到 QueryTest.java 中 ， 修 改 
main () 函数 以 调用 它 ， 如 下 所 示 : 





System.out.println (titlesContainingText ("v", session) ) ; 
运行 这 个 版 本 的 程序 ， 将 产生 以 下 输出 : 
qtest: 

[java] [Video Killed the Radio Star, Gravity's Angel] 











很 显然 ， 通 过 投影 也 可 以 检索 回 那 些 不 在 Restrictions 表 达 式 中 的 各 
属性 。 如 果 我 们 想得到 曲目 长 度 ， 可 以 这 样 做 : 





criteria.setProjection (Projections.property ("playTime") ) ; 





它 的 输出 结果 是 : 





qtest: 
[java] [00: 03: 49, 00: 06: 06] 





当然 ， 方 法 名 称 看 起 来 好 像 不 对 ， 和 输出 结果 也 不 明了 。 如 宁 我 们 既 
想 取 回 标题 ， 也 想 取 回 长 度 ， 那 该 怎么 办 ? 其 实 也 很 简单 ， 如 例 8-14 所 
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例 8-14: 投影 到 两 个 属性 





/** 
*Retrieve the titles and play times of any tracks that contain a 


*particular text string. 
大 








*@param text the text to be matched, ignoring case, anywhere in 
the title. 


*@param session the Hibernate session that can retrieve data. 
*@return the matching titles and times wrapped in object arrays. 
x 
public static List titlesContainingTextWithPlayTimes (String 
text, 
Session session) { 
Criteria criteria=session.createCriteria (Track.class) ; 
criteria.add (Restrictions.like ("title", text, 
MatchMode. ANYWHERE ) 
.ignoreCase () ) ; 
criteria.setProjection (Projections.projectionList © .@ 
add (Projections.property ("title") ) .@ 
add (Projections.property ("playTime") ) ) ; 
return criteria. list. () ; 


} 












































@projectionList © 方法 创建 一 个 ProjectionList 实 例 ， 它 可 以 包含 
应 用 于 一 个 条 件 查 询 的 多 个 投影 选择 。 注 意 ， 我 们 正在 使 用 的 是 例 8-5 
介绍 的 简洁 的 链 式 标记 法 ， 这 样 就 不 需要 再 声明 一 个 变量 来 持 有 这 个 实 


例 了 。 








@ 接 着 ， 我 们 只 要 将 所 有 需要 的 投影 添加 到 ProjectionList， 再 将 这 
个 ProjectionList 实 例 传递 给 条 件 查 询 对 象 的 setProjection() 方法 。 





这 里 最 不 容易 处 理 的 是 从 碍 询 返 回 的 结果 。 和 前 面 的 一 样 ， 它 也 是 
一 个 List， 但 现在 每 个 列表 元 素 要 包含 多 个 值 ， 而 且 这 些 值 的 类 型 还 可 
能 不 同 。Hibernate 采 用 的 办 法 是 返回 一 个 对 象 数 组 的 列表 。 以 下 这 段 代 
码 用 于 显示 返回 的 列表 ， 看 起 来 有 些 复杂 : 














for (Object o: titlesContainingTextWithPlayTimes ("v", session) ) { 
Object [Jarray= (Object[]) o; 

System.out .Println ("Title: "+array[0]+ 

"(Play Time: "+tarray[1]+') ') ; 








它 将 输出 以 下 内 容 : 





qtest: 
[java] Title: Video Killed the Radio Star (Play Time: 00: 03: 49) 
[java]Title: Gravity's Angel (Play Time: 00: 06: 06) 














确实 ， 这 段 代 码 看 起 来 很 妖 ， 你 绝对 不 应 该 在 现实 中 按 这 样 的 方式 
来 使 用 投影 。 对 象 /关系 映射 系统 的 要 点 就 是 你 可 以 只 返回 对 象 ， 在 需 
要 一 些 属性 时 ， 再 用 这 些 对 象 来 得 到 你 要 的 属性 。 这 样 的 话 ， 为 什么 投 
影 要 文 持 多 个 值 ? 咽 ， 事 实 上 是 存在 好 的 理由 的 ， 它 与 我 们 在 本 节 开 始 
介绍 的 “聚合 "的 概 候 有 关 。 很 多 时 候 在 使 用 投影 时 ， 经 闻 会 得 到 原来 根 
本 不 直接 属于 任何 对 象 的 值 ， 只 是 这 些 值 会 基于 东 些 对 象 的 属性 。 例 8- 
15 演 示 了 一 个 方法 ， 它 会 输出 数据 库 中 的 每 种 曲目 来 源 媒 介 ， 以 及 来 目 
这 种 媒介 的 所 有 曲目 的 数量 ， 还 有 这 种 媒介 的 曲目 的 最 长 播放 时 间 。 























例 8-15: 和 带 有 聚合 的 投影 





/** 
*Print statistics about various media types. 
* 








*@param session the Hibernate session that can retrieve data. 
xy. 

public static void printMediaStatistics (Session session) { 
Criteria criteria=session.createCriteria (Track.class) ; 
criteria.setProjection (Projections.projectionList () .@ 

add (Projections.groupProperty ("sourceMedia") ) .四 

add (Projections.rowCount () ) .@ 

add (Projections.max ("playTime") )); @ 

for (Object o: criteria.list © ) 10 

Object [Jarray= (Object[]) o; 
































System.out .println (array[0]+"track count: "+tarray[1]+ 
"; max play time: "tarray[2]) ; 

} 

} 





注意 : 现在 我 们 正在 利用 数据 库 的 功能 做 些 很 有 意思 的 事 ! 
这 个 例子 涉及 我 们 目前 为 止 见 到 的 许多 事情 : 


和 @@ 和 以 前 一 样 ， 我 们 正在 创建 一 个 ProjectionList 实 例 来 持 有 想 要 得 
询 返 回 的 各 个 项 。 





@egroupProperty O 方法 与 我 们 目前 使 用 过 的 property O 方法 类 
似 ， 但 它 是 告诉 Hibernate 将 指定 的 属性 对 记录 进行 分 组 ， 所 有 值 相 同 的 
记录 就 成 为 结果 集中 的 一 条 记录 。 分 组 是 执行 聚合 操作 的 关键 ， 能 让 我 
们 为 投影 增加 聚合 值 。 











@rowCount O 投影 不 需要 任何 参数 ， 因 为 它 只 是 返回 分 组 到 当前 
结果 集中 的 记录 的 总 数 〈 基 于 我 们 的 groupProperty © 的 值 ， 
sourceMedia) 。 这 束 是 我 们 计算 属于 每 种 来 源 媒 介 类 型 的 曲目 数量 的 方 
ae 


Omax ©) 投影 返回 分 组 的 结果 集中 某 个 属性 的 最 大 值 。 


四 最 后 ， 我 们 用 类 似 前 面 例子 中 创建 的 输出 循环 ， 循 环 志 历 条 件 查 
询 返 回 的 Object 数组 的 List， 并 输出 它们 。 





在 QueryTest.java 的 main ©) 函数 中 调用 这 个 方法 很 简单 : 





printMediaStatistics (session) ; 











它 会 生成 以 下 输出 : 
qtest: 

[java]CD track count: 4; max play time: 00: 07: 39 
[Java] VHS track count: 1; max play time: 00: 03: 49 
[java] STREAM track count: 1; max play time: 00: 07: 05 
[java]null track count: 1; max play time: 00: 00: 10 





这 一 结果 应 该 会 让 你 对 投影 和 聚合 的 真正 价值 有 所 了 解 Cul a 
类 型 供 我 们 测试 使 用 〉。 





不 过 ， 能 够 看 到 ， 这 一 输出 并 没有 按 任何 顺序 进行 排序 。 我 们 可 能 
想 进行 排序 ， 但 是 你 怎么 对 投影 结果 排序 呢 ? 答案 就 是 我 们 需要 看 看 
Criteria API 中 的 另 一 个 改进 。 你 可 以 为 对 象 和 属性 分 配 “ 别 名 ”， 以 供 我 
们 处 理 使 用 《〈“ 怠 像 在 数据 库 碍 询 语言 中 为 表 和 列 起 的 别名 一 样 ) ， 而 不 
论 它 们 是 直接 来 自 数 据 库 ， 还 是 来 目 投影 和 聚 合 操作 。 这 样 ， 我 们 按照 
来 源 媒 介 进 行 排 序 就 容易 了 ， 只 需要 为 分 组 后 的 属性 添加 一 个 别名 : 




















add (Projections.groupProperty ("sourceMedia") .as ("media") ) . 
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排序 ， 束 像 我 们 前 面 对 普 通 的 对 象 属性 进行 排序 一 样 : 





criteria.addOrder (Order.asc ("media") ) ; 
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qtest: 





] 
[java]CD track count: 4; max play time: 00: 07: 39 
[java] STREAM track count: 1; max play time: 00: 07: 05 
[java]VHS track count: 1; max play time: 00: 03: 49 








之 所 以 使 用 别名 还 有 些 其 他 原因 ， 使 用 投影 也 还 可 以 完成 更 多 的 事 








到 哪里 可 以 学 习 到 更 多 的 相关 内 容 。 


在 关联 中 应 用 条 件 碍 询 








到 目前 为 止 ， 在 条 件 碍 询 的 构建 上 ， 我 们 看 到 的 都 是 查询 同一 个 类 
的 各 种 属性 。 当 然 ， 在 真实 的 系统 中 ， 对 象 之 间 有 丰富 的 关联 藉 系 。 有 
时 ， 我 们 想 用 于 过 小 结果 的 细 市 是 来 源 于 这 些 关 联 。 斑 好， 条件 查 询 
API 提 供 了 一 种 相当 简明 的 方式 可 以 执行 这 样 的 搜索 。 














应 该 怎么 做 





假设 我 们 想 找 出 与 特定 艺人 相关 联 的 所 有 曲目 。 我 们 需要 的 碍 询 就 
征 检查 每 个 Track 对 象 的 artists 属 性 中 包含 的 值 。artists 属 性 是 一 个 集合 ， 
包含 与 菏 个 曲目 相关 的 所 有 Artist 对 象 的 关联 。 为 了 让 得 询 过 程 更 有 趣 
些 ， 再 假设 我 们 想 找 到 姓名 属性 匹配 特定 子 字符 串 〈substring) 的 艺人 
相关 联 的 所 有 曲目 。 








我 们 在 QueryTest.java 里 新 增加 一 个 方法 来 实现 这 一 功能 。 新 增 的 方 
法 如 例 8-16 所 示 ， 就 放 在 tracksNoLongerThan O 方法 之 后 。 


例 8-16: 根据 艺人 关联 来 过 小 曲目 


/** 

*Retrieve any tracks associated with artists whose name matches a 
SOL 

*string pattern. 

* 


*@param namePattern the pattern which an artist's name must match 

*@param session the Hibernate session that can retrieve data. 

*@return a list of {@link Track}s meeting the artist name 
restriction. 

x4 

public static List tracksWithArtistLike (String namePattern, 
Session session) 

{ 

Criteria criteria=session.createCriteria (Track.class) ; 

Criteria artistCriteria=criteria.createCriteria ("artists"); @ 

artistCriteria.add (Restrictions.like ("name", namePattern) ); @ 

artistCriteria.addOrder (Order.asc ("name") .ignoreCase () ); © 

return criteria.list ©); 


} 










































































@ 前 面 开 始 的 代码 看 起 来 很 熟悉 ， 这 一 行 接着 再 用 曲目 对 象 的 
artists 必 性， 又 创建 了 一 个 Criteria 实 例 ， 附 加 到 我 们 用 于 选择 曲目 的 那 
个 Criteria 实 例 上 。 这 意味 着 我 们 或 者 可 以 增加 约束 到 criteria 上 《应 用 到 
Track 自身 的 属性 ) ， 或 者 加 到 artistCriteria 上 〈 应 用 到 与 曲目 关联 的 
Artist 实 体 的 属性 ) 。 


多 在 这 个 例子 中 ， 我 们 只 对 艺人 的 信息 感 兴趣 ， 所 以 我 们 将 结果 限 
制 为 与 艺人 相关 联 的 曲目 ， 这 些 曲 目的 世人 中 至 少 要 有 一 个 艺人 的 名 称 
必须 匹配 指定 的 模式 (再 一 次 ， 通 过 将 约束 应 用 到 两 个 Criteria 实 例 上 ， 
我 们 就 能 够 同时 限制 Track 和 Artist 的 属性 ) 。 


注意 : 最 终 ， 在 本 书 的 这 一 版 本 中 ， 能 够 看 到 我 原本 期 望 已 久 的 输 
出 结果 。 





全 我 们 要 求 授 世 人 的 名 字 排 序 。 编 写本 书 第 1 版 时 ， 与 当时 可 以 使 


AW RA ZATEA Criteria API 相 比 ， 这 是 Hibernate3 带 来 的 又 一 个 改 
进 。 原 来 只 能 够 对 最 外 层 的 条 件 查 询 进 行 排 序 ， 但 不 能 对 为 关联 而 创建 
的 子 条 件 查 询 进行 排序 。 如 果 试 图 这 么 做 ， 束 会 得 到 一 个 


UnsupportedOperationEXception 。 








为 了 看 到 这 一 得 询 的 执行 结果 ， 我 们 还 得 做 个 修改 。 修 改 main O 
方法 ， 让 它 调 用 这 个 新 查询 ， 如 例 8-17 所 示 。 


例 8-17: 调用 新 的 曲目 世人 姓名 查询 





//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 

try 

//Print tracks associated with an artist whose name ends with"n" 
List tracks=tracksWithArtistLike ("3n", session) ; 

for (ListIterator iter=tracks.listIterator () ; 












































现在 执行 ant qtest， 可 以 得 到 例 8-18 所 示 的 结果 。 


例 8-18: 与 姓名 以 字母 "" 结 尾 的 艺人 相关 联 的 所 有 曲目 





qtest: 
[java]Track: "The World'99" (Pulp Victim, Ferry Corsten) 00: 07: 
05, 
from Digital Audio Stream 
[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (William 
Orbit, 
Samuel Barber, Ferry Corsten) 00: 06: 35, from Compact Disc 
[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact 
Disc 





























EA 


2a] ras 


注意 : 你 也 可 以 为 用 到 的 关联 建立 别名 ， 并 在 表达 式 中 使 用 。 这 会 
让 情形 变 得 更 复杂 ， 但 是 有 用 。 改 天 研究 一 下 吧 。 


如 果 碍 看 这 三 个 曲目 的 艺人 列表 ， 就 会 用 现 每 个 曲目 的 艺人 姓名 中 
至 少 有 一 个 以 "结尾 ， 符 合 我 们 的 要 求 。 另 外 注意 ， 我 们 也 可 以 访问 
与 曲目 相关 联 的 所 有 艺人 ， 而 并 非 只 限于 匹配 name 条 件 的 艺人 。 这 正 是 
预期 的 效果 ， 也 是 想 要 的 效果 ， 因 为 我 们 已 经 检索 回 实际 的 Track 实 
体 。 你 可 以 调用 
setResultTransformer (Criteria.ALIAS_TO_ENTITY_MAP) 方法 来 以 不 
同 的 模式 执行 条 件 查 询 ， 让 它 返 回 一 个 层次 式 的 Map 对 象 的 列表 ， 条 件 
查询 会 将 结果 过 滤 到 这 个 Map 列 表 的 每 个 层次 中 。 这 部 分 主题 已 经 超出 
本 书 讨论 的 范围 ， 但 是 在 Hibernate 参 考 手册 和 API 文 档 中 提供 了 一 些 示 
例 。 








如 果 供 你 取 回 对 象 的 数据 表 可 能 含有 重复 的 实体 ， 可 以 调用 Criteria 
对 象 的 setResultTransformer (Criteria. DISTINCT_ROOT_ENTITY) Ù 
法 ， 以 达到 与 SQL 语 句 的 "select distinct" 相 同 的 效果 。 


ZN toll Ve] 
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要 寻找 的 日 标 ， 束 能 够 以 它 为 示例 ， 让 Hibernate 为 你 建立 查询 条 件 。 


应 该 怎么 做 


我 们 需要 在 QueryTest.java 里 新 增加 另 一 个 查询 方法 ， 将 例 8-19 的 代 
码 添 加 到 其 他 得 询 所 在 类 的 顶端 。 


例 8-19: 使 用 示例 实体 来 生成 条 件 查 询 






































/** 

*Retrieve any tracks that were obtained from a particular source 
media 

*type 

* 

*@param media the media type of interest. 

*@param session the Hibernate session that can retrieve data. 

*@return a list of{@link Track}s meeting the media restriction. 

ay 

public static List tracksFromMedia (SourceMedia media, Session 





session) { 
Track track=new Track (); @ 
track.setSourceMedia (media) ; 
Example example=Example.create (track) ; © 
Criteria criteria=session.createCriteria (Track.class) ; @ 
criteria.add (example) ; 
criteria.addOrder (Order.asc ("title") ) ; 
return criteria.list () ; 


} 























种 我 们 先 创建 示例 用 的 Track 实例 ， 再 设置 SourceMedia 属 性 ， 以 表 
示 我 们 要 查询 的 内 容 。 








四 接着 将 它 包 装 到 一 个 Example 对 象 中 。 这 个 对 象 可 以 在 一 定 程度 
上 让 你 控制 在 构建 条 件 碍 询 时 将 会 用 什么 属性 ， 以 及 如 何 匹配 字符 串 。 
默认 的 行为 是 ， 值 为 null 的 属性 将 被 忽略 ， 对 字符 串 值 按照 区 分 大 小 写 
的 、 逐 字 的 方式 进行 比较 。 如 果 想 在 比较 时 忽略 值 为 0 的 属性 ， 可 以 调 
用 example 的 excludeZeroes() 方法 ; 或 者 ， 如 果 和 希望 对 值 为 null 的 属性 
进行 匹配 ， 可 以 调用 excludeNone () 。 而 excludeProperty ©) 方法 则 可 
以 让 你 明确 地 忽略 指定 名 称 的 特定 属性 ， 不 过 这 很 像 是 在 手工 构建 条 件 
查询 。 为 了 调整 字符 串 处 理 ， 还 可 以 使 用 jignoreCase O 和 
enableLike O 方法 ， 从 它们 的 名 字 可 以 知道 各 自 的 用 途 。 





会 接着， 我们 创建 一 个 条 件 查 询 ， 就 像 本 章 的 其 他 例子 一 样 ， 不 同 
的 是 这 里 为 条 件 查 询 增 加 的 是 example， 而 不 是 使 用 Restrictions 来 创建 
Criterion。Hibernate 会 负责 将 example 转 换 成 相应 的 criteria。 其 他 代码 行 
与 我 们 前 面 的 查询 方法 类 似 : 建立 排序 序列 ， 运 行 查 询 ， 返 回 匹 配 的 实 
体 列 表 。 








同样 地 ， 为 了 调用 新 的 查询 方法 ， 我 们 也 必须 修改 main ©) 方法 。 
把 来 目 CD 的 曲目 都 找 出 来 吧 。 修 改 之 处 如 例 8-20 所 示 。 





例 8-20: 修改 main〈) 方法 ， 以 调用 示例 驱动 的 碍 询 方法 


//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 

try{ 

//Print tracks that came from CDs 

List tracks=tracksFromMedia (SourceMedia.CD, session) ; 

for (ListIterator iter=tracks.listIterator () = 












































运行 这 个 版 本 的 示例 ， 产 生 的 输出 如 例 8-21 所 示 。 





例 8-21: 以 示例 碍 询 来 和 目 CD 的 曲目 的 结果 




















[java]Track: "Adagio for Strings (ATB Remix) " (ATB, Samuel 
Barber, 
William Orbit) 00: 07: 39, from Compact Disc 
[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Samuel 
Barber, William Orbit, Ferry Corsten) 00: 06: 35, from Compact Disc 
[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact Disc 
[java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 






































你 可 能 觉得 这 个 例子 有 些 做 作 ， 因 为 我 们 并 没有 合适 的 Track 对 象 
可 以 作为 示例 ， 因 此 得 在 这 个 方法 中 创建 一 个 示例 。 嗯 ， 也 许 吧 ， 但 是 
采用 此 方法 有 个 很 有 价值 的 理由 : 与 纯 条 件 查 询 相 比 ， 这 种 方法 在 编译 
期 间 会 做 更 多 的 检查 。 虽 然 条 件 查 询 可 以 避免 HQL 查 询 在 运行 时 的 语法 
结构 错误 ， 但 你 还 是 可 能 会 和 弄 错 属性 的 名 称 。 而 这 些 错误 是 编译 器 无 法 
捕获 的 ， 因 为 名 称 只 是 字符 串 而 已 。 当 你 建立 示例 查询 时 ， 实 际 上 是 以 
该 实体 的 存 取 器 方法 (1 ) (mutator method) 来 设置 属性 值 的 内 容 。 
这 意味 着 ， 如 果 你 输入 错字 ，Java 会 在 编译 期 间 就 捕获 到 它 。 























你 大 概 想 得 到 ， 也 可 以 让 子 条 件 查 询 〈subcriteria) 使 用 示例 来 查 
询 相 关联 的 对 象 。 我 们 可 以 重 写 tracksWithArtistLike () ， 使 用 一 个 作 
为 示例 用 的 Artist 对 象 ， 而 非 自己 手工 建立 查询 条 件 。 最 后 再 调用 示例 
对 象 的 enableLike O 方法 。 例 8-22 演 示 了 完成 这 一 功能 的 简洁 方法 。 





例 8-22: 更 新 艺人 姓名 但 询 ， 使 用 一 个 艺人 对 象 作为 示例 








public static List tracksWithArtistLike (String namePattern, 
Session session) 

{ 

Criteria criteria=session.createCriteria (Track.class) ; 
Example example=Example.create (new Artist (namePattern, null, 
null) ) ; 

criteria.createCriteria ("artists") .add (example.enableLike () ) .a 

Order.asc ("name") .ignoreCase () ) ; 

return criteria.list © ; 


} 






































这 一 过 程 的 输出 与 我 们 前 面 “ 手 工 ? 构 建 的 内 部 条 件 碍 询 生 成 的 输出 
完全 一 样 。 如 果 你 想 运 行 这 个 例子 ， 记 得 把 main() 换 回 例 8-17 的 样 
T3 





注意 : 条 件 查 询 相 当 简 单 ， 对 吧 ? 和 原来 Hibernate 2 中 的 相 比 ， 现 
在 它们 的 功能 更 强大 ， 我 更 喜欢 它们 了 。 


各 种 各 样 的 查询 可 以 增强 用 户 界 面 的 功能 ， 数 据 驱 动 〈data- 
driven〉 的 Java 应 用 程序 的 典型 操作 也 可 以 表示 成 条 件 查 询 。 在 可 读 
性 、 编 译 期 类 型 检查 甚至 是 代码 紧 读 性 〈 令 人 惊讶 ) 等 各 方面 ， 条 件 查 
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1 存 取 器 方法 指 对 象 提 供 的 用 于 访问 其 实例 变量 接口 的 方法 。 用 于 近 
回 实例 变量 值 的 存 取 器 方法 称 为 获取 方法 ( 即 get 方 法 ) ; 用 于 为 实例 变 
量 赋值 的 存 取 器 方法 称 为 设置 方法 〈 即 Set 方法) o 


面 癌 属性 的 Criteria 工 三 


我 们 已 经 看 到 ， 使 用 Criteria API 来 表达 你 想 要 实现 的 僵 询 ， 通 第 部 
会 有 多 种 方法 ， 到 底 使 用 哪 一 种 方法 取决 于 你 对 系统 风格 的 偏好 或 考虑 
问题 的 方式 。Property 类 提供 了 另 一 组 符 换 方法 ， 你 应 该 对 此 有 所 了 
解 。 我 们 在 这 里 不 会 深入 研究 这 个 类 ， 因 为 它 只 是 建立 条 件 查 询 的 为 一 
种 方法 。 不 过 ， 解 释 一 下 它 的 工作 原理 ， 也 很 重要 ， 这 样 才 不 至 于 在 运 
行 许多 示例 时 感到 困惑 ， 也 不 至 于 在 浏览 Hibernate 局 密度 的 JavaDoc 时 
感觉 有 阻碍 。 (坦率 地 说 ， 经 过 一 两 个 示例 以 后 ， 你 肯定 对 以 后 会 采用 
什么 方法 而 有 足够 的 想法 了 。) 


Property 是 条 件 查 询 的 另 一 个 工厂 类 ， 与 Restrictions 非 常 像 ， 本 章 
已 经 用 过 了 Restrictions〈 还 有 Order 和 Projection， 都 差不多 ) 。 其 实 ， 
只 使 用 Property 就 完全 可 以 创建 其 他 工厂 类 提供 的 所 有 查询 约束 条 件 。 
不 像 前 面 那样 是 先 从 感 兴趣 的 约束 条 件 开始 ， 再 为 需要 使 用 的 属性 命 
名 ，Property 是 先 从 属性 开始 ， 再 挑选 一 个 合适 的 约束 条 件 。 





注意 : 相当 抽象 ! 演示 些 例 子 吧 ! 


和 以 前 一 样 ， 先 在 想 要 但 询 的 对 象 上 创建 一 个 Criteria。 但 接 下 来 不 
征用 以 前 的 方法 ， 例 如 : 





criteria.add (Restrictions.le ("playTime", length) ) ; 








而 是 用 : 








criteria.add (Property.forName ("playTime") .le (length) ) ; 





这 两 条 语句 看 起 来 非常 像 〈 只 是 侧重 点 稍微 有 些 不 同 ) ， 就 像 用 英 
语 来 表达 同一 个 概念 时 也 有 多 种 方法 一 样 。Property 类 也 提供 了 很 多 方 
法 ， 用 于 添加 约束 条 件 、 排 序 以 及 投影 。 不 能 使 用 new〈) 方法 来 构造 
一 个 Property 实 例 ， 你 需要 使 用 它 的 forName O 静态 工厂 方法 ， 或 是 使 
用 一 个 现 有 的 Property 实 例 ， 再 调用 它 的 getProperty O 方法 ， 将 其 转换 
为 它 的 某 个 组 成 属性 。 


以 下 列举 一 些 更 复杂 的 例子 ， 以 演示 这 种 方法 适用 的 场合 。 原 来 我 
们 使 用 过 以 下 语句 : 





criteria.addOrder (Order.asc ("name") .ignoreCase () ) ; 





现在 可 以 使 用 以 下 语句 : 








criteria.addOrder (Property.forName ("name") .asc O .ignoreCase (). 








对 于 投影 ， 原 来 用 的 方法 是 ， 例 如 : 





criteria.setProjection (Projections.max ("playTime") ) ; 





与 之 等 价 的 方法 可 以 表示 成 : 





criteria.setProjection (Property.forName ("playTime") .max O) ) ; 











注意 : 1X fe] EL eA E TORS A! 








这 样 ， 你 需要 从 众多 选择 中 挑选 一 种 实现 方法 。 有 时 ， 你 正在 着 手 
解决 的 问题 ， 或 是 代码 中 其 他 部 分 的 难点 ， 将 决定 使 用 某 种 风格 的 实现 
方式 。 或 者 ， 也 许 你 只 是 更 豆 欢 一 种 方法 ， 束 一 二 坚 持 使 用 这 种 方法 
了 。 但 是 ， 至 少 你 现在 知道 了 可 能 会 遇 到 两 种 表达 方法 ， 应 该 能 够 理解 
任何 一 种 条 件 表 达 式 。 附 录 B 对 所 有 这 些 工厂 方法 进行 了 总 结 。 








选择 太 多 了 吗 ? 没有 ? 咽 ， 如 果 条 件 查 询 还 不 能 很 好 的 解决 你 的 问 
题 ， 或 者 你 希望 有 一 种 更 加 强大 的 方法 来 取代 本 章 介绍 的 所 有 选择 〈 从 
本 质 来 说 ， 如 果 你 更 喜欢 SQL 的 简洁 ) ， 你 就 可 以 使 用 HQL 提 供 的 更 为 
完整 的 功能 。 我 们 在 下 一 章 融 会 研究 HQL。 


其 他 


在 条 件 查询 中 可 以 悄悄 用 点 SQL， 以 便 可 以 利用 些 数 据 库 特定 的 功 
能 或 DBA 技 巧 ? 使 用 子 查 询 ， 或 是 通过 离线 (detached〉 Ai, MEE 
你 在 一 个 Hibernate session 之 外 创建 一 个 查询 ? 当 执行 查询 时 ， 可 以 插入 
自己 的 Java 代 码 来 过 滤 结 果 ? 所 有 这 些 主题 ， 可 能 还 有 更 多 其 他 的 ， 已 








经 超出 本 书 讨论 的 范围 。 如 果 你 准备 学 习 它 们 ，“《Java Persistence with 
Hibernate) (|H!) 这 本 书 的 "Advanced query options" (高 级 查询 选项 ) 
一 章 就 提供 了 一 个 好 的 概览 ，Hibernate JavaDoc 和 源 代 码 也 是 不 错 的 参 


1] 中 文书 名 叫 《Hibetrnate 实 战 》 。 


第 9 章 ” 浅 谈 HQL 
前 面 几 音 已 经 多 次 用 过 HQL 查 询 了 。 这 里 值得 花 点 时 间 来 了 解 HQL 


和 SQL 的 差异 ， 看 看 能 用 HQL 做 些 什 么 有 用 的 事 。 和 本 书 其 他 章节 一 
和 示例 ， 而 不 是 完整 的 参考 手册 。 





样 ， 我 们 则 在 提供 有 用 的 简介 


y — 


HO 


在 第 7 章 曾经 提 到 ，JPA 的 查询 语言 是 HQL 的 一 个 子 集 。 所 以 ， 如 
果 学 会 了 HQL， 也 应 该 能 够 读 懂 JPA 碍 询 语言 (QL) ， 如 果 ， 你 用 JPA 
编写 查询 ， 那 么 你 就 有 足够 的 理由 去 超越 它 。 大 多 数 情 况 下 ， 只 要 付出 








很 小 的 努力 ， 束 可 以 学 会 如 何 使 用 Hibernate 了 。 
正如 第 7 章 结尾 所 述 ， 本 章 的 示例 将 使 用 XML 映射 文件 。 所 以 ， 如 
果 你 在 前 面 因 为 处 理 标 注 而 修改 了 什么 东西 ， 在 开始 学 习 本 章 以 前 ， 最 


好 先 下 载 示例 代码 ， 并 放 到 本 章 的 目录 中 。 


Fn Sj HQLES HJ 
HQL 查 询 中 用 到 的 语法 成 分 会 比 SQL 的 少 点 ( 比 


我 们 已 经 演示 过 ， 
如 在 第 3 章 中 ， 我 们 使 用 的 碍 询 语 句 通常 束 省 略 了 "select" 子 句 ) 。 事 实 





上 ， 人 惟一 真正 需要 指定 的 内 容 束 是 你 感 兴趣 的 类 。 例 9-1 显 示 了 一 个 最 
简单 的 查询 ， 对 于 取得 数据 库 中 所 有 持久 保存 的 Track 实例 来 次 ， 这 完 





全 是 一 种 有 效 的 方式 。 





注意 : HQL 代 表 Hibernate Query Language. HSQL? 这 得 看 你 问 
的 是 谁 了 。 


例 9-1: 最 简单 的 HQL 查 询 





from Track 





没什么 内 容 ， 对 吧 ? 这 一 HQL 就 相当 于 例 8-1， 在 那个 例子 中 我 们 
对 Track 类 建立 了 一 个 条 件 查 询 ， 但 没有 提供 任何 查询 条 件 。 








默认 情况 下 ，Hibernate 会 自动 “导入 ”(import) 你 映射 的 每 个 类 的 
名 称 ， 这 意味 着 当 你 想 使 用 一 个 类 时 ， 不 必 提 供 完整 的 包 名 称 ， 只 需要 
简单 的 类 名 就 可 以 了 。 只 要 映射 的 类 名 称 是 惟一 的 ， 就 不 需要 在 查询 中 
使 用 完整 限定 的 类 名 (fully qualified classname) 。 如 果 你 喜欢 ， 当 然 
也 可 以 这 么 做 ， 本 书 就 是 这 样 做 的 ， 目 的 是 帮助 读者 记 住 查询 是 按照 
Java 数 据 bean 及 其 属性 来 表示 的 ， 而 并 非 数 据 表 和 字段 (在 SQL 查 询 中 
使 用 这 些 ) 。 例 9-2 的 结果 和 第 一 个 查询 的 结果 完全 相同 。 














例 9-2: 显 式 指定 包 名 ， 但 依然 相当 简单 





from com.oreilly.hh.data.Track 





如 果 需 要 映射 的 多 个 类 具有 相同 的 名 称 ， 你 可 以 用 完全 限定 的 包 名 
来 引用 每 个 类 ， 也 可 以 在 其 映射 文件 中 使 用 import 标 签 为 该 类 或 多 个 关 





指定 蔡 换 名 称 。 还 可 以 在 映射 文件 中 为 最 顶层 的 hibernate-mapping 标 签 
属性 添加 一 个 auto-import=false 设 置 ， 以 关 挥 上 自动 导入 (auto-import) 的 





你 可 能 已 经 习惯 编写 查询 语句 时 不 区 分 大 小 写 ， 因 为 SQL 的 行为 就 
是 如 此 。 大 多 数 时 候 ，HQL 也 是 如 此 。 但 是 类 和 属性 的 名 称 显然 是 例 
外 。 和 Java 的 其 他 组 成 部 分 一 样 ， 它 们 是 区 分 大 小 写 的 ， 所 以 你 得 把 大 
小 写 弄 对 。 


让 我 们 看 一 个 极端 的 示例 ， 它 把 HQL 的 多 态 (polymorphic) 查询 能 
力 推 回 它 的 逻辑 上 的 极限 ， 以 此 来 了 解 HQL 和 SQL 完 竞 在 哪 不 同 。 


应 该 怎么 做 








突出 SQL 和 HQL 基 本 兰 别 的 最 有 效 方式 就 是 ， 考 谍 当 以 "from 
java.lang.Object" 来 进行 查询 时 会 发 生 什 么 事 。 乍 一 看 ， 可 能 看 不 出 什么 
意义 ! 事实 上 ，Hibernate 能 够 文 持 返回 多 态 结果 的 查询 。 如 果 映 射 到 的 
类 之 间 是 彼此 继承 的 ， 或 者 有 共同 的 基 类 或 接口 ， 那 么 无 论 是 否 将 这 些 
类 映射 到 相同 的 数据 表 或 不 同 的 数据 表 ， 都 可 以 碍 询 到 它们 的 超 类 
(superclass) 。 由 于 每 个 Java 对 象 都 继承 目 Object， 上 所 以 这 样 的 查询 就 
等 于 要 求 Hibernate 返 回 数据 库 里 的 每 个 实体 。 我 们 可 以 对 但 询 测 试 做 个 
快速 的 修改 ， 以 测试 一 下 这 一 查询 。 把 QueryTest.java 复 制 成 














QueryTest3.java， 按 例 9-3 所 示 的 内 容 对 它 进 行 修 改 〈 大 多 数 修改 都 是 将 
这 里 不 需要 的 示例 碍 询 删除 掉 ， 上 所 以 例 9-3 中 看 不 到 那些 被 删除 的 部 


ip 





如 果 你 正在 使 用 Eclipse， 那 么 可 以 直接 跳 到 第 11 章 ， 阅 读 有 关 
Hibernate Tools 的 章节 ， 再 回来 继续 学 习 本 章 的 内 容 。 那 一 章 介绍 的 
HQL Editor 是 一 个 非常 方便 的 工具 ， 可 以 帮助 你 处 理 我 们 需要 得 看 的 各 
种 查询 。 用 它 来 做 实验 太 有 效 了 ， 可 以 接合 你 自己 的 修改 ， 帮 助 你 更 深 
入 地 学 习 HQL。 





例 9-3: 看 吧 ， 再 也 不 用 SQL 了 





package com.oreilly.hh; 












































import org.hibernate.*; 

import org.hibernate.cfg.Configuration; 

import org.hibernate.criterion.®*; 

import com.oreilly.hh.data.*; 

import java.util.*; 

/** 

*Retrieve all persistent objects 

*/ 

public class QueryTest3{ 

/** 

*Look up and print all entities when invoked from the command 
line. 

ey 





public static void main (String args[]) throws Exception { 
//Create a configuration based on the properties file we've put 
//in the standard place. 
Configuration config=new Configuration () ; 

config.configure () ; 

//Get the session factory we can use for persistence 
SessionFactory sessionFactory=config.buildSessionFactory () ; 
//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 





















































try{ 

//Print every mapped object in the database 
List all=session.createQuery ("from java.lang.Object") .list O; Q 
for (Object obj: all) { 

System.out .println (obj); © 

} 

}finally{ 

//No matter what, close the session 
session.close () ; 

} 

//Clean up after ourselves 
sessionFactory.close () ; 

} 

} 























@ 这 行 简 蛙 的 代码 就 调用 了 奇妙 而 功能 强大 的 HQL 查 询 。 








@ 接 下 来 所 有 需要 做 的 就 是 循环 遍历 和 打印 输出 我 们 找到 的 结果 。 
除了 调用 取 回 的 对 象 的 toString O 方法 以 外 ， 我 们 什么 也 不 能 做 ， 
为 我 们 不 知道 它们 是 什么 类 。 作 为 共享 接口 ，Object 没 有 提供 非常 深入 
的 方法 。 


在 运行 这 个 示例 之 前 ， 还 得 再 多 做 一 件 事 。 在 build.xml 中 添加 男 一 
个 构建 目标 ， 如 例 9-4 所 示 。 


和 以 前 一 样 ， 假 设 你 已 经 按照 前 面 章节 的 说 明 搭建 好 了 环境 。 也 可 
以 直接 下 载 使 用 为 这 一 章 提 供 的 示例 源 代 码 。 如 有 末 你 从 第 7 草 过 来 ， 将 
映射 文档 换 成 了 标注 ， 则 要 么 你 需要 回 到 第 6 章 的 源 代 码 ， 要 人 么 重新 下 
载 本 章 的 源 代码 ， 因 为 本 章 的 这 些 示例 需要 依 徘 映 财 文件 的 功能 





例 9-4: 调用 这 个 特殊 得 询 





<target name="gtest3"description="Retrieve all mapped objects" 
depends="compile"> 
<java classname="com.oreilly.hh.QueryTest3"fork="true"> 
<classpath refid="project.class.path"/> 





</java> 
</target> 








为 了 确保 创建 好 所 有 的 样 例 数据 ， 先 要 运行 ant schema ctest atest 命 
令 。 接 着 ， 再 执行 ant qtest3 命 令 以 测试 新 的 查询 ， 得 到 的 结果 如 例 9-5 所 


>| 


o 





例 9-5: Hibernate 能 找到 一 切 事物 





Sant qtest3 





Buildfile: build.xml 





prepare: 
usertypes: 
codegen: 

[hibernatetool] 

















Configuration 














compile: 











[javac]Compiling 4 source 


Executing Hibernate Tool with a Standard 








[hibernatetool]l.task: hbm2java (Generates a set of.java files) 


to/Users/jim/Documents/Work/OReilly 


/svn_hibernate/current/examp] 


qtest3: 





[java] com.oreil 
[java] com.oreil] 





ly.hh. 
ly.hh. 











ull'] 


Buggles'actualArtist='n 


[java]com.oreilly.hh. 


Anderson'actualArti 


st="null'] 
[java]com.oreil 








Orbit'actualArtist 
='null'] 
[java]com.oreil]l 














Corsten'actualArtist 


='null'] 





[java]com.oreilly.hh. 


ly.hh. 


ly.hh. 























files 
les/ch09/classes 

data. Artist@8al37c[name='PPK'actualArtist='nu 
data.Artist@79e4c [name='The 
data.Artist@29ae5e[name='Laurie 
data.Artist@76a9b6 [name='William 
data.Artist@801919[name='Ferry 
data.Artist@efe4ac[name='Samuel 











='nul] 
[java] 
[java] 


Victim'actualArtist 


1] 


='nu] 


1 '] 


com.oreil 


Barber'actualArtist 








com.oreil 


ly.hh.da 
ly.hh.da 











[java] 





com.oreil 





ly.hh.da 





L.Gore'actualArtist 





='"nul 


1] 











[java] 


com.oreilly.hh.data.AlbumTrack@132{ 
title='Compulsion'volume='Vol 
right=100] 'sourceMedia=' 
om.oreilly.hh.data.AlbumTrack 
[n a Manner oi 
right=100] 





tle='] 


CDJ] 
com.oreil 





ta. Ar 


tis 











ta. Ar 


tis 














ta. Ar 


com.oreilly.hh.data.Alb 
e.p.'tracks='[ 


7? 





k@10cf 





right=100 


Media= 
ly.hh.data.AlbumTracké{ 


com.oreil 


] 'source 
SED] ys 

















tis 








t@8el3ab[name='ATB'actualArtist='nu 
t@ad44f6 [name='Pulp 








t@8aaed5 [name='Martin 


um@alé644b[title='"Counterfeit 








ume [le 


F26[track='com.oreilly.hh.data.T 
ft=100, 





CD']'], c 




















@5ael 





01 


[track='com.oreilly.hh.data.Tr 














f Speaking'volume='Volume[left=100, 
"sourceMedia=' 





ly.hh.data.AlbumTrack@6al6ae[track='com.oreilly.hh.data.Trac 
62[title='Smile in the Crowd'volume='Volume[left=100, 








F7309a[track='com.oreilly.hh.da 








F78[track='com.oreilly.hh.data.Trac 
Back on Mother 


ta.Track@9f332b[title='Gone'volume='Volume [left=100, 
right=100] 'sourceMedia=' 

CD'j'], 
com.oreilly.hh.data.AlbumTrack@97c! 

k@d86cae[title='Never Turn Your 
Earth'volume='Volume[left=100, 

right=100] 'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@b5d53a[track= 

"com.oreilly.hh.data.Track@c74b55[title='Motherless 
Child'volume='Volume[left= 























[java] 


Trance 'volume='Vol 








[java] 
Radio Sta 


ume[le 


'volume='Volume 


com.oreil 





TE 
































100, right=100] 'sourceMedia='CD']'J]'] 
com.oreilly.hh.data.Track@e74d83 


[title='Russian 


ft=100, right=100] 'sourceMedia='CD"'] 
ly.hh.data.Track@5d8362 


[title='Video Killed the 


[left=100, right=100] 'sourceMedia='VHS'] 

















[java]com.oreilly.hh.data.Track@5c9ab5[title='Gravity's 
Angel 'volume='Vo 
lume [left=100, right=100] 'sourceMedia='CD"'] 
[java]com.oreilly.hh.data.Track@b0e76a[title='Adagio for 
Strings (Ferry C 
orsten Remix) 'volume='Volume[left=100, 
right=100] 'sourceMedia='CD"] 
[java]com.oreilly.hh.data.Track@28ea3f[title='Adagio for 








Strings (ATB Rem 

ix) 'volume='Volume[left=100, right=100] 'sourceMedia='CD"] 
[java]com.oreilly.hh.data.Track@2af08b[title='The 
World'99'volume='Volu 
me[left=100, right=100] 'sourceMedia='STREAM' ] 
[java]com.oreilly.hh.data.Track@164feb[title='Test Tone 









































[left=50, right=75] 'sourceMedia='null'] 
[java]com.oreilly.hh.data.Track@d8f£246[title='Compulsion'volume='V 
left=100, right=100] 'sourceMedia='CD'] 
[java]com.oreilly.hh.data.Track@9eab7 [title='In a Manner of 
Speaking'vol 
ume='Volume[left=100, right=100] 'sourceMedia='CD"] 
[java]com.oreilly.hh.data.Track@10cf62[title='Smile in the 
Crowd'volume= 
"Volume [left=100, right=100] 'sourceMedia='CD'] 
[java]com.oreilly.hh.data.Track@9f332b[title='Gone'volume='Volume [ 
00, right=100] 'sourceMedia='CD"'] 
[java]com.oreilly.hh.data.Track@d86cae[title='Never Turn Your Back 
on Mot 
her EBarth'volume='Volume[left=100, right=100] 'sourceMedia='CD"] 
[java]com.oreilly.hh.data.Track@c74b55[title='Motherless 
Child'volume='V 
olume [left=100, right=100] 'sourceMedia='CD'] 
BUILD SUCCESSFUL 
Total time: 9 seconds 







































































































































































BET APA St 


HE, FA, TYAN fai, [Al Hibernate 4} il) (Wee JL 
SQL 碍 询 才 能 获得 我 们 想 要 的 所 有 结果 。Hibernate 在 幕后 做 了 很 多 工 
作 ， 才 能 把 每 个 它 知 道 的 持久 化 实体 的 列表 交 给 我 们 。 虽 然 很 难 想象 实 
际 需 要 这 么 做 的 情况 ， 但 这 确实 突出 了 HQL 和 Hibernate 有 趣 的 能 力 所 





E 





有 时 候 某 些 查 询 确实 有 些 难 以 理解 ， 但 却 非 常 有 用 。 所 以 记 住 这 一 








点 很 有 价值 : 路 表 的 多 态 查 询 (polymorphic query) 不 仅 可 行 ， 而 且 容 
易 使 用 。 





当 你 执行 需要 多 条 SQL 碍 询 才 能 完成 的 HQL 奉 询 时 ， 会 有 些 限 制 需 
要 注意 。 不 能 使 用 order by 子 句 对 整个 结果 集 进 行 排序 ， 也 不 能 使 用 
Query 接 口 scroll() 方法 授 历 整个 结果 集 。 





其 他 


关联 〈association) 和 连接 Goin) WE? 这 些 也 容易 处 理 。 只 要 使 用 
点 号 作为 分 隔 符 〈delimiter) ， 顺 着 属性 链 走 ， 就 能 访问 关联 对 象 。 为 
了 帮助 你 引用 查询 表达 式 中 的 特定 实体 ，HQL 可 以 让 你 指定 别名 就 像 
SQL 一 样 ) 。 如 果 你 想 引 用 同一 个 类 的 两 个 不 同 的 实体 ， 别 名 就 特别 重 
有 要， 例如: 











from com.oreilly.hh.Track as trackl 





相当 于 : 








from com.oreilly.hh.Track tracki 





采用 哪 一 种 方法 取决 于 你 的 习惯 ,或 者 取决 于 你 为 项 目 准备 的 编码 
风格 指南 。 





我 们 对 其 他 HQL 元 素 进 行 了 足够 的 介绍 ， 束 是 想 让 它们 吸引 起 你 的 
兴趣 。 稍 后 我 们 会 看 看 一 些 连 接 的 示例 。 


选择 属性 和 其 他 部 件 


到 目前 为 止 ， 我 们 用 的 查询 返回 的 都 是 整个 持久 化 对 象 。 这 是 像 
Hibernate 这 类 对 象 /关系 映射 服务 组 件 最 常见 的 用 法 ， 所 以 应 该 没什么 
可 奇怪 的 。 在 得 到 这 些 持 久 化 对 象 以 后 ， 就 可 以 在 你 熟悉 的 Java 代 码 世 
界 中 用 它们 做 任何 你 想 做 的 事 。 但 是 在 有 些 情况 下 ， 你 可 能 只 想 取出 组 
成 对 象 的 所 有 属性 的 一 个 子 集 ， 例 如 生成 报表 。HQL 也 能 满足 这 样 的 需 
要 ， 和 普通 SQL 的 使 用 方式 一 样 ， 也 就 是 在 select 子 句 中 使 用 SQL 投影 
(SQL-projection) 。 





应 该 怎么 做 


假设 我 们 想 在 QueryTest.java 的 基础 上 进行 修改 ， 使 其 只 显示 符合 查 
询 条 件 的 曲目 的 标题 ， 而 且 想 从 数据 库 中 一 开始 提取 的 信息 就 只 包含 曲 
目的 标题 。 首 先 ， 要 修改 例 3-11 的 查询 ， 让 它 只 检索 回 title 属 性 。 编 辑 
Track.hbm.xml， 使 其 查询 内 容 看 起 来 如 例 9-6 所 示 。 








例 9-6: 只 获取 短 曲 目的 标题 





<query name="com.oreilly.hh.tracksNoLongerThan"> 

<! [CDATA[ 

select track.title from com.oreilly.hh.Track as track 
where track.playTime<=: length 

] ] 人 > 

</query> 








要 确保 让 QueryTestjava 中 的 tracksNoLongerThan (©) 方法 使 用 这 个 
得 询 。《〈 如 果 你 在 第 8 章 将 它 修 改 成 使 用 条 件 碍 询 ， 就 要 再 改 回 例 3-12 
的 样子 。 为 了 节省 查找 的 麻烦 ， 例 9-7 又 重新 生成 了 一 次 。) 











例 9-7: HQL 张 动 的 查询 方法 ， 使 用 例 9-6 中 映射 的 查询 





public static List tracksNoLongerThan (Time length, Session 
session) { 

Query query=session.getNamedQuery (人 

"com.oreilly.hh.tracksNoLongerThan") ; 

gquery.setTime ("length", length) ; 

return query. last () ; 


} 











最 后 ， 还 需要 更 新 main O 方法 〈 如 例 9-8 所 示 ) ， 以 反映 一 个 事 
K: 这 个 查询 方法 现在 返回 的 是 title 属 性 ， 而 不 是 整个 Track 记录 。 这 个 
属性 的 类 型 是 String， 所 以 ， 现 在 这 个 查询 方法 返回 的 是 一 个 由 String 组 
成 的 List 对 象 。 











例 9-8: 修改 QueryTest 的 main O 方法 ， 以 处 理 标题 查询 

















//Print the titles of tracks that will fit in five minutes 
List titles=tracksNoLongerThan (Time.valueOf ("00: 05: 00") ， 
session) ; 

for (ListIterator iter=titles.listIterator () |; 

iter.hasNext (); ) { 

String title= (String) iter.next © ; 

System.out.printlin ("Track: "+title) ; 

} 


es | 



































这 些 修改 都 相当 简单 ， 而 Java 程 序 中 查询 返回 的 类 型 和 List 元 素 之 
间 的 关系 也 一 目 了 然 。 使 用 ant qtest 命 令 运 行 这 个 例子 ， 就 会 得 到 类 似 
例 9-9 的 输出 结果 ， 至 于 实际 显示 的 数据 ， 则 取决 于 你 已 经 设 定 的 数 
据 。《 如 果 还 没有 任何 数据 ， 或 者 你 想 要 的 结果 ， 输 出 前 可 以 执行 ant 
schema ctest atest qtest， 这 样 会 重建 测试 数据 。) 








例 9-9: 只 列 出 时 间 长 度 不 超过 5 分 钟 的 曲目 的 标题 





qtest: 

[java]Track: Russian Trance 

[java]Track: Video Killed the Radio Star 
[java]Track: Test Tone 1 
[java]Track: In a Manner of Speaking 

[java]Track: Gone 

[java]Track: Never Turn Your Back on Mother Earth 
[java]Track: Motherless Child 





























其 他 





要 返回 多 个 属性 ? 当然 可 以 。 如 果 你 使 用 连接 Goin) 或 者 你 的 查 
询 对 象 中 有 多 个 组 件 或 关联 《毕竟 这 是 面向 对 象 关联 非常 方便 的 方 
Th) ， 在 这 些 情况 下 ， 属 性 都 可 以 来 自 多 个 对 象 。 如 同 SQL 那 样 ， 你 所 
做 的 就 是 列 出 需要 的 属性 ， 并 以 去 号 分 隔 。 举 一 个 简单 的 例子 ， 假 设 我 
们 要 得 到 曲目 的 标题 和 ID。 调 整 Track.hbm.xml， 使 查询 内 容 如 例 9-10 所 
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例 9-10: 从 一 个 对 象 中 选择 多 个 属性 


一 
<query name="com.oreilly.hh.tracksNoLongerThan"> 
<! [CDATA[ 
select track.id, track.title from com.oreilly.hh.Track as track 
where track.playTime<=: length 
] ] 人 > 
</query> 











IRA i BE TIE, he DAI 4 AIR SE, IRAE 
递 相 同 的 命名 参数 ， 再 返回 保存 有 结果 的 列表 。 但 是 这 个 列表 中 现在 包 
含 什 么 ? 我 们 需要 更 新 main《〈) 中 的 循环 ， 才 能 同时 显示 曲目 的 ID 和 标 








jel 


像 这 种 情况 ， 人 查询 结 果 的 每 一 “ 行 ”(row)〉 都 要 返回 多 个 值 ， 所 以 
Hibernate 返 回 的 List 对 象 中 的 每 个 条 目 都 会 包含 一 个 对 象 数 组 。 每 个 数 
组 都 包含 我 们 所 选择 的 属性 ， 排 列 顺序 按照 各 属性 在 查询 语句 中 的 位 置 
而 定 。 这 样 ， 我 们 会 得 到 一 个 包含 两 个 元 素 的 数组 的 列表 ， 每 个 数组 内 
包含 一 个 Integer 对 象 ， 再 接着 包含 一 个 String 对 象 。 











例 9-11 演 示 了 如 何 更 新 QueryTest.java 中 的 main () ， 以 处 理 这 些 数 
组 。 


例 9-11: 处 理 查 询 结 果 中 多 个 单独 的 属性 











//Print IDs and titles of tracks that will fit in five minutes 
List titles=tracksNoLongerThan (Time.valueOf ("00: 05: 00") ， 
session) ; 

for (ListIterator iter=titles.listIterator () |; 

iter.hasNext (); ) { 
Object []row= (Object []) iter.next © ; 
Integer id= (Integer) row[0]; 












































String title= (String) row[1]; 
System.out .println ("Track: "taTitle+"[ID="+idt']'") ; 
} 

















经 过 这 些 修改 以 后 ， 执 行 ant qtest， 可 以 得 到 类 似 例 9-12 的 输出 。 


例 9-12: 列 出 曲目 的 标题 和 ID 





qtest: 

[java]Track: Russian Trance [ID=1] 

[java]Track: Video Killed the Radio Star[ID=2] 
[java]Track: Test Tone 1[ID=7] 
[java]Track: In a Manner of Speaking [ID=9] 
[java]Track: Gone [ID=11] 

[java]Track: Never Turn Your Back on Mother Earth[ID=12] 
[java]Track: Motherless Child[ID=13] 





















































我 布 望 你 在 看 这 个 示例 时 会 想 : “这 种 使 用 Track 对 象 属性 的 方法 真 
FEL ”。 如 果 你 没 这 么 想 ， 比 较 一 下 例 9-11 和 例 3-7 中 的 对 应 代码 。 后 者 
更 为 精简 而 自然， 长 至 能 够 显示 出 更 多 的 曲目 信息 。 如 果 要 提取 出 映射 
对 象 的 信息 ， 最 好 是 充分 利用 映射 的 能 力 以 提取 出 对 象 的 真正 的 实例 ， 
这 样 你 就 能 用 表达 能 力 更 强 而 且 类 型 安全 的 Java 代 码 来 处 理 它 的 属性 。 








注意 : 这 是 那 种 残酷 的 玩笑 吗 ? 


既然 如 此 ， 为 什么 还 要 这 样 做 ? 嗯 ， 在 某 些 情况 下 ， 用 HQL 检 索 回 
多 个 值 有 其 用 途 所 在 。 例 如 ， 对 菏 些 映射 类 ， 你 只 想 从 每 个 类 中 取出 一 
个 属性 ， 或 者 ， 你 可 能 想 通 过 在 select 子 句 中 列 出 一 些 类 名 来 返回 一 组 
相关 的 类 。 对 于 这 些 情况 而 言 ， 知 道 这 种 技巧 有 其 价值 所 在 。 如 果 你 的 





PN TAA IR AAA CER EIE IORI) 属性 ， 但 你 只 对 其 中 的 
一 两 个 属性 感 兴趣 ， 这 一 技巧 也 许 能 在 性 能 上 让 你 受益 菲 浅 。 


此 外 ， 当 你 从 不 同 映射 对 象 中 选择 一 大 组 属性 以 建立 报表 时 ， 还 有 
男 一 种 技巧 可 以 用 来 方便 地 构建 良好 的 对 象 结构 。HQL 可 以 让 你 在 
select 子 句 内 构建 并 返回 任意 对 象 。 所 以 ， 你 可 以 创建 一 个 专门 的 报表 
类 ， 它 的 属性 就 是 你 的 报表 需要 的 值 ， 然 后 在 查询 中 返回 这 个 报表 类 的 
实例 ， 而 不 是 返回 星 涩 难 懂 的 Object 数 组 。 如 果 我 们 定义 一 个 具有 id 和 
title 属 性 的 TrackSummary 类 ， 以 及 与 之 相配 的 构造 函数 ， 如 此 一 来 就 能 
够 使 用 以 下 的 查询 : 





select new TrackSummary (track.id, track.title) 








而 不 是 使 用 : 


select track.id, track.title 


这 样 ， 我 们 就 不 用 在 处 理 得 询 结果 的 代码 中 对 数组 进行 处 理 。《 和 再 
一 次 ， 就 这 个 例子 来 说 ， 简 单 地 返回 整个 Track 实例 是 比较 有 意义 的 ， 
但 是 当 你 要 使 用 来 目 多 个 对 象 的 属性 或 者 像 聚 合 函 数 Caggregate 
function) 这 类 合成 结果 时 《后 面 会 有 演示 ) ， 这 样 做 加 有 用 处 了 。) 





排序 





可 以 使 用 SQL 风格 的 "order by" 子 句 控制 结果 输出 的 顺序 ， 这 应 该 不 
会 令 你 感到 惊讶 。 前 面 几 章 我 们 曾经 简单 提 到 过 这 一 点 ， 其 工作 原理 正 
如 你 所 料想 的 那样 。 可 以 使 用 返回 对 象 的 任何 属性 来 建立 排序 ， 也 可 以 
使 用 多 个 属性 来 建立 子 排序 〈subsort) ， 以 便 在 第 一 个 属性 值 相同 时 能 
够 继续 以 其 他 属性 值 对 其 结果 进行 排序 。 








应 该 怎么 做 


排序 非常 简单 : 列 出 想 要 用 来 对 查询 结果 进行 排序 的 值 。 和 往 第 一 
样 ，SQL 使 用 数据 库 表 的 字段 ， 而 HQL 使 用 对 象 的 属性 。 对 于 例 9-13 来 
说 ， 我 们 更 新 了 例 9-10 的 查询 ， 让 它 以 倒序 的 字母 顺序 显示 结果 。 


注意 : 和 SQL 一 样 ， 递 增 的 顺序 使 用 "asc"， 而 递减 的 顺序 使 
用 "desc"。 


例 9-13: 在 Track.hbm.xml 中 加 点 新 东西 ， 按 标题 倒序 对 结果 进行 排 
序 


<query name="com.oreilly.hh.tracksNoLongerThan"> 

<! [CDATA[ 

select track.id, track.title from com.oreilly.hh.Track as track 
where track.playTime<=: length 

order by track.title desc 











11> 
</query> 





运行 这 个 示例 的 输出 结果 如 你 所 料 《〈《 如 例 9-14 所 示 ) 。 


例 9-14: 以 倒序 的 字母 顺序 列 出 的 标题 和 ID 





Sant qtest 
Buildfile: build.xml 
prepare: 
[copy]Copying 1 file 
to/Users/jim/Documents/Work/OReilly/svn_ hibernate 
/current/examples/ch09/classes 
usertypes: 























java]Track: Video Killed the Radio Star[ID=2] 
java]Track: Test Tone 1[1ID=7] 

[java]Track: Russian Trance [ID=1] 

[java]Track: Never Turn Your Back on Mother EHarth[ID=12] 


























java]Track: Motherless Child[ID=13] 
java]Track: In a Manner of Speaking[ID=9] 























[java]Track: Gone [ID=11] 
BUILD SUCCESSFUL 
Total time: 9 seconds 














使 用 聚合 值 


我 们 时 第 需要 从 数据 库 中 提取 摘要 信息 ， 尤 其 是 在 做 报表 的 时 候 : 
有 多 少 ? 平均 值 ? 最 长 的 ? HQL 也 支持 这 一 功能 ， 办 法 就 是 提供 与 5QL 
类 似 的 聚合 函数 〈aggregate function) 。 当 然 ， 在 HQL 中 ， 这 些 函 数 是 
针对 持久 化 类 的 属性 而 进行 运算 的 。 








应 该 怎么 做 





我 们 以 目前 现 有 的 一 些 查 询 测试 框架 为 基础 试 一 试 吧 。 首 先 ， 在 
Track.hbm.xml 中 现 有 的 查询 内 容 之 后 再 新 添加 例 9-15 所 示 的 查询 内 容 。 








例 9-15: 一 个 用 于 收集 曲目 的 聚合 信息 的 碍 询 





<query name="com.oreilly.hh.trackSummary"> 

<! [CDATA[ 

select count (*) , min (track.playTime) , max (track.playTime) 
from Track as track 

11> 

</query> 








我 原来 试图 取出 平均 播放 时 间 ， 但 很 不 乌 ，HSQLDB 不 知道 应 该 如 
何 为 非 数 值 的 字段 计算 平均 值 ， 因 为 这 个 属性 是 保存 在 数据 库 类 型 为 
date (日 期 ) 的 字段 中 。 





接 下 来 ， 我 们 必须 写 一 个 方法 去 执行 这 个 碍 询 ， 并 显示 结果 。 把 例 
9-16 所 示 的 代码 加 进 QueryTest.java， 束 放 在 tracksNoLongerThan() 方 
法 的 后 面 。 


例 9-16: 执行 trackSummary 人 查询 的 方法 





/** 
*Print summary information about all tracks. 
大 











*@param session the Hibernate session that can retrieve data. 
xx / 
public static void printTrackSummary (Session session) { 
Query 

query=session.getNamedQuery ("com.oreilly.hh.trackSummary") ; 
Object []results= (Object[]) query.uniqueResult O) ; 
System.out.println ("Summary information: ") ; 
System.out.println ("Total tracks: "+results[0]) 
System.out.printlin ("Shortest track: "+results[1 
System.out.println ("Longest track: "+results[2] 


} 

















9 

















] ) ; 
) ; 





由 于 我 们 只 在 查询 中 使 用 聚合 函数 ， 因 此 我 们 知道 返回 的 结果 只 会 
有 一 行 数据 。 在 这 种 情况 下 ， 束 可 以 使 用 Query 接 口 提供 的 力 一 个 更 加 
方便 的 uniqueResult《〈) 方法 ， 这 样 能 免 去 取 回 一 个 列表 ， 并 把 列表 的 
第 一 个 元 系 取 出 来 的 雁 烦 。 如 本 节 前 面 的 9.2 市 所 述 ， 因 为 我 们 要 求 的 
古 儿 个 不 同 的 值 ， 因 此 结果 将 会 是 一 个 Object 数 组 ， 其 元 素 束 是 我 们 请 
求 的 那些 值 ， 它 们 的 顺序 与 查询 结果 中 的 排列 顺序 相同 。《〈 这 段 代 码 看 
起 来 有 些 难 看 ， 使 用 了 临 汐 难 懂 的 数字 式 数组 引用 。 这 就 是 我 们 演示 的 
为 什么 需要 为 查询 创建 “报表 对 象 "的 原因 了 ， 使 用 报表 对 象 将 会 让 处 理 
变 得 比 现在 要 方便 得 多 。 在 普通 的 SQL 语句 中 ， 你 可 以 为 字段 起 个 名 











称 ， 通 过 名 称 从 ResultSet《〈 结 采集 ) 中 取 回 字段 值 ; 在 HQL 中 ， 你 可 以 
声明 类 ， 并 在 碍 询 中 创建 这 个 类 的 实例 。) 


我 们 还 需要 在 main《〈) 中 新 添加 一 行 代码 来 调用 这 个 方法 。 可 以 将 
这 行 代码 放 在 打印 输出 选择 的 曲目 详细 信息 的 循环 之 后 ， 如 例 9-17 所 
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9-17: 在 QueryTest.java 中 的 main〈) 中 新 增加 一 行 ， 以 显示 新 的 


摘要 信息 





System.out .println ("Track: "t+taTitle+"[ID="+anID+']") ; 
}printTrackSummary (session) ; 

}finally{ 

//No matter what, close the session 




















[java]Track: Video Killed the Radio Star[ID=2] 
[java]Track: Test Tone 1[ID=7] 

[java]Track: Russian Trance [ID=1] 

[java]Track: Never Turn Your Back on Mother Earth[ID=12] 
[ ]Track: Motherless Child[ID=13] 

[java]Track: In a Manner of Speaking[ID=9] 

[java] Track: Gone [ID=11] 

[java]Summary information: 
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[java]Total tracks: 13 
[java]Shortest track: 00: 00: 10 
[java]Longest track: 00: 07: 39 
BUILD SUCCESSFUL 

Total time: 9 seconds 




















相当 简单 吧 。 我 们 再 试 试 比较 难处 理 的 一 从 连接 表 中 获取 信息 。 曲 
目 有 一 个 关联 到 艺人 的 集合 。 假 设 我 们 想 取出 和 特定 艺人 相关 联 的 曲目 
的 摘要 信息 ， 而 不 是 所 有 曲目 的 摘要 信息 。 例 9-19 演 示 了 碍 询 语句 中 新 
增加 的 部 分 。 





例 9-19: 获取 特定 艺人 相关 的 曲目 摘要 信息 





<query name="com.oreilly.hh.trackSummary"> 

<! [CDATA[ 

select count (*) , min (track.playTime) , max (track.playTime) 
from Track as track 
where: artist in elements (track.artists) 
11> 

</query> 














为 了 过 滤 想 看 到 的 曲目 ， 我 们 新 增 了 一 个 where 子 句 ， 以 及 一 个 命 
名 参数 artist。Hibernate 的 mn 运 算 符 还 有 男 外 一 个 用 途 ， 可 以 像 在 普通 的 
SQL 语 句 中 那样 来 使 用 in 运 算 符 以 给 定 某 个 属性 可 能 取 值 的 列表 ， 也 可 
以 按 这 里 采用 的 方式 来 使 用 in。 这 个 语句 是 告诉 Hibernate， 我 们 感 兴趣 
的 曲目 是 其 artists 集 合 中 含有 特定 艺人 的 那些 曲目 。 为 了 调用 这 一 碍 
询 ， 需 要 对 print-TrackSummary () 做 点 修改 ， 如 例 9-20 所 示 。 


例 9-20: 改进 printTrackSummary © ， 以 处 理 特定 艺人 的 曲目 





/** 
*Print summary information about tracks associated with an artist. 
* 








*@param artist the artist in whose tracks we're interested. 
*@param session the Hibernate session that can retrieve data. 
** / 
public static void printTrackSummary (Artist artist, Session 
session) { 
Query 
query=session.getNamedQuery ("com.oreilly.hh.trackSummary") ; 
query.setParameter ("artist", artist) ; 
Object []results= (Object[]) query.uniqueResult O) ; 
System.out.printlin ("Summary of tracks by"+artist.getName () 
+': '); 





















































System.out.println ("Total tracks: "+results[0]) ; 
System.out.printlin ("Shortest track: "+results[1]) ; 
System.out.println ("Longest track: "+results[2]) ; 


} 





没 多 加 什么 ， 对 吧 ? 最 后 ， 调 用 该 方法 的 那 行 代码 需要 用 一 个 参数 
来 指定 一 个 世人 对 象 。 我 们 可 以 再 次 使 用 CreateTest.java 中 方便 的 
getArtist () 方法 。 修 改 QueryTestjava 的 main O 方法 中 对 该 方法 的 调 
用 代码 ， 使 其 如 例 9-21 所 示 。 


例 9-21: 调用 已 改进 的 print, TrackSummary () 





System.out.println ("Track: "+title+"[ID="+id+']') ; 

} 

printTrackSummary (CreateTest.getArtist ("Samuel Barber", 
false, session) , session) ; 

finally{ 

//No matter what, close the session 


























aS 





现在 ， 当 你 执行 ant qtest 时 ， 就 会 看 到 类 似 例 9-22 的 信息 。 


例 9-22: 运行 摘要 查询 ， 以 取得 艺人 Samuel Barber 的 所 有 曲目 





qtest: 

[java]Track: Video Killed the Radio Star[ID=2] 
[java]Track: Test Tone 1[ID=7] 

[java]Track: Russian Trance [ID=1] 

[java]Track: Never Turn Your Back on Mother Earth[ID=12] 
[java]Track: Motherless Child[ID=13] 
[java]Track: In a Manner of Speaking[ID=9] 
[java]Track: Gone [ID=11] 

[java]Summary of tracks by Samuel Barber: 
[java]Total tracks: 2 

[java]Shortest track: 00: 06: 35 

[java]Longest track: 00: 07: 39 






























































RETTAR 


注意; 试 着 以 普通 的 SQL 做 类 似 的 事 ! 


这 根本 不 费 吹 灰 之 力 ， 因 此 值得 花 点 时 间 来 欣赏 一 下 Hibernate 为 我 
们 做 了 多 少 事 。 我 们 调用 的 getArtist O 方法 会 返回 与 "Samuel 
Barber" 对 应 的 Artist 实 例 ， 再 将 整个 实例 对 象 作为 命名 参数 传递 给 HQL 
查询 ， 而 Hibernate 也 知道 应 该 如 何 使 用 Artist 对 象 的 id 属 性 和 
TRACK_ARTISTS 表 ， 把 连接 查询 放 在 一 起 ， 以 实现 我 们 在 例 9-10 中 简 
单 描述 的 那 种 复杂 情况 。 


得 到 的 结果 反映 出 示例 数据 中 那 两 个 艺人 相互 混合 的 "Adagio for 
Strings" 曲 目 。 因 为 它们 都 超过 了 5 分 钟 ， 所 以 没有 出 现在 曲目 列表 中 。 


编写 原生 SQL 查询 


HQL 的 功能 强大 、 使 用 方便 ， 而 且 能 和 Java 代 码 中 的 对 象 自然 地 结 
合 起 来 ， 既 然 如 此 ， 有 什么 理由 不 去 用 HQL 呢 ? 嗯 ， 项 目 所 用 的 数据 库 
可 能 有 某 些 特殊 功能 是 它 原 生 (native) 的 SQL 方言 才 支 持 的 ， 这 时 就 
不 能 用 HQL 了 。 如 果 你 愿意 接受 使 用 原生 SQL 会 让 以 后 数据 库 的 更 换 变 
得 更 加 困难 的 事实 ，Hibernate 还 是 可 以 让 你 使 用 这 种 原生 SQL 方言 来 编 
写 查 询 ， 同 时 仍然 帮助 你 以 对 象 属性 的 方式 来 编写 表达 式 ， 并 把 查询 结 
果 转 换 成 对 象 ( 当 然 ， 如 果 你 不 想 依 靠 Hibernate 的 帮助 ， 也 可 以 使 用 原 
始 的 JDBC 连 接 来 执行 普通 的 SQL 碍 询 ) 。 








另 一 种 可 能 不 完全 符合 你 的 情况 是 ， 你 正 处 于 将 当前 现 有 的 基于 
JDBC 的 项 目 移 植 到 基于 Hibermate 的 过 程 中 ， 而 你 只 是 想 先 前 进 几 小 
步 ， 并 不 想 立 刻 彻 底 重 新 改写 每 个 查询 。 








应 该 怎么 做 


如 果 准 备 将 查询 语句 的 文本 舱 入 到 Java 源 代码 中 ， 可 以 用 Session 类 
的 createSQLQuery〈) 方法 ， 而 不 是 用 例 3-7 的 createQuery O 方法 。 当 
然 ， 你 应 该 知道 有 比 这 种 编码 方式 更 好 的 办 法 ， 所 以 我 就 不 举例 说 明 这 
种 方法 了 。 比 较 好 的 做 法 是 把 查询 语句 放 在 映射 文档 中 ， 如 例 3-11 所 





AR. IX BIZEF, PLEDGE AA <sql-query>ims&, MERIAH 
的 query 标 签 。 你 也 需要 告诉 Hibernate 要 返回 什么 映射 类 ， 以 及 在 查询 
中 引用 该 类 (及 其 属性 〉 的 别名 是 什么 。 








假设 我 们 想 知 道 所 有 恰好 结束 在 半分 钟 的 曲目 〈 换 句 话说 ， 自 动 唱 
片 机 系统 显示 的 播放 时 间 是 h: mm: 30) ， 不 过 ， 这 个 例子 有 点 做 作 。 
简单 的 方法 束 是 使 用 HSQLDB 内 建 的 ECOND 函 数 ， 它 会 返回 Time 值 中 
秒 数 的 部 分 。 由 于 HQL 不 知道 HSQLDB SQL 方 言 中 这 一 特殊 的 函数 ， 所 
以 我 们 只 得 使 用 原生 的 SQL 查 询 。 例 9-23 演 示 了 这 个 例子 的 实现 ， 将 它 
添加 到 Track.hbm.xml 中 的 HQL 查 询 之 后 。 


例 9-23: 在 Hibernate 映 射 文档 中 藤 入 一 个 原生 的 SQL 方言 查询 








<sql-query name="com.oreilly.hh.tracksEndingAt"> 
<return alias="track"class="com.oreilly.hh.data.Track"/> 
<! [CDATA[ 

select{track.*} 

from TRACK as{track} 

where SECOND ({track}.PLAYTIME) =: seconds 

11> 

</sql-query> 


























retum 标 俭 是 告诉 Hibernate， 我 们 准备 在 查询 中 使 用 track 别 名 来 引 
用 Track 对 象 ， 这 样 就 能 够 在 查询 语句 中 使 用 简写 的 {track.*} 来 引用 
TRACK 数据 表 中 所 希 要 的 所 有 字段 以 创建 Track 实例 〈 注 意 ， 在 碍 询 语 
句 中 这 样 使 用 别名 时 必须 用 大 括号 将 别名 括 起 来 。 这 能 让 我 们 “脱离 ” 原 
生 的 SQL 语 句 环境 ， 用 Hibernate 映 射 类 和 属性 来 描述 查询 内 容 〉。 





查询 中 的 where 子 句 使 用 了 HSQLDB SECOND 函 数 来 过 滤 查 询 结 
果 ， 只 在 结果 中 保留 时 间 长 度 值 的 秒 数 部 分 具有 特定 值 的 曲目 。 幸 好 ， 
即便 我 们 构建 了 一 个 原生 的 SQL 查询 ， 依 然 能 够 利用 Hibernate 很 棒 的 命 
名 碍 询 参数 。 在 这 个 示例 中 ， 我 们 传递 了 一 个 名 为 "seconds" 的 值 以 控制 
查询 返回 的 结果 。 “即便 在 SQL 查询 中 ， 也 不 需要 使 用 大 括号 来 告诉 
Hibernate 你 正在 使 用 命名 参数 。Hibemate 的 解析 器 足够 智能 ， 以 致 于 可 
以 自动 明白 你 写 的 是 什么 。) 





使 用 该 映射 SQL 碍 询 的 代码 和 前 面 示 例 中 使 用 HQL 碍 询 的 代码 并 没 
有 什么 不 同 。 可 以 用 getNamedQuery ©) 方法 来 加 载 这 两 种 查询 ， 而 且 
这 两 种 查询 都 实现 了 Query 接 口 。 所 以 ， 调 用 该 得 询 的 Java 方 法 看 起 来 
应 该 很 熟悉 。 将 例 9-24 中 的 代码 添加 到 QueryTest.java 中 
printTrackSummary () 方法 的 后 面 。 





例 9-24: 调用 原生 的 SQL 映射 查询 





/** 
*Print tracks that end some number of seconds into their final 


minute. 
* 











*@param seconds, the number of seconds at which we want tracks to 
end. 
*@param session the Hibernate session that can retrieve data. 
xx / 
public static void printTracksEndingAt (int seconds, Session 
session) { 

Query 
query=session.getNamedQuery ("com.oreilly.hh.tracksEndingAt") ; 
query.setInteger ("seconds", seconds) ; 
List results—query. list: () ; 
for (ListIterator iter=results.listIterator () ; 









































iter.hasNext (); ) { 
Track track= (Track) iter.next © ; 
System.out.printin ("Track: "+track.getTitle ©) + 
", length="+track.getPlayTime () ) ; 
} 
} 





最 后 ， 在 main O 中 加 上 几 行 代码 以 调用 这 个 方法 。 例 9-25 演 示 了 
将 其 添加 到 对 printTrackSummary O 的 调用 之 后 的 样子 。 





例 9-25: 调用 printTracksEndingAt () 以 显示 终止 于 半分 钟 的 曲目 





printTrackSummary (CreateTest.getArtist ("Samuel Barber", 
false, session) , session) ; 
System.out.println ("Tracks ending halfway through final 
minute: ") ; 
printTracksEndingAt (30, session) ; 
finally{ 
//No matter what, close the session 


























AR 








[java]Track: Video Killed the Radio Star[ID=2] 








ava]Summary of tracks by Samuel Barber: 
ava]Total tracks: 2 

ava]Shortest track: 00: 06: 35 

ava]Longest track: 00: 07: 39 

ava]Tracks ending halfway through final minute: 
ava]Track: Russian Trance, length=00: 03: 30 























Loh Tal toss: Rot bal. 


BUILD SUCCESSFUL 
Total time: 10 seconds 




















与 HQL 查 询 相 比 ， 使 用 原生 SQL 查询 时 需要 注意 更 多 不 同 层 次 上 的 
细节 ， 也 更 乏味 《尤其 是 当 你 的 查询 变 得 复杂 或 涉及 对 多 个 数据 表 的 引 
用 时 ) ， 但 是 ， 它 偶尔 会 在 茶 些 场合 真 的 可 以 派 上 用 场 ， 这 也 是 一 件 好 








从 Hibernate 3 起 ，sql-query 了 映射 也 成 为 在 Hibernate 中 操纵 数据 库存 
储 过 程 的 入 口 点 《如 果 这 些 与 你 没什么 关系 ， 不 必 担 心 ， 这 只 是 意味 着 
你 现在 还 不 需要 为 它们 操心 ， 当 你 需要 使 用 它们 时 ， 就 会 知道 是 怎么 回 
E) 。 对 于 可 以 调用 的 碍 询 的 种 类 ， 以 及 查询 可 以 返回 的 类 型 ， 都 有 
一 些 明 确 的 限制 ， 而 且 这 些 限制 会 随 着 数据 库 的 不 同 而 有 所 不 同 。 更 详 
尽 的 细节 ， 可 以 查看 Hibernate 参 考 手册 CM!) 。 





还 有 其 他 的 东西 吗 ? 你 会 怀疑 本 章 几 乎 没有 谈 到 用 HQL 可 以 做 
些 什么 。 的 确 如 此 。 妆 你 开始 结合 这 些 功 能 ， 并 运用 集合 、 关 联 以 及 功 
能 强大 的 表达 式 时 ， 就 能 完成 一 些 令 人 刊 目 相 看 的 事情 。 我 们 不 可 能 在 
这 本 介绍 性 的 图 书 中 涉及 方方面面 的 细节 ， 所 以 你 得 上 自己 去 阅读 
Hibernate 参 考 手册 中 有 关 HQL 的 那 一 节 及 其 示例 ， 然 后 再 自己 做 些 实 
验 。 














当 你 阅读 Hibernate 参 考 手 册 中 有 关 "Hibernate Query Language" ¢ |?! 
) 的 那 一 章 时 ， 一 定 要 看 看 表达 式 中 能 用 到 的 那些 有 趣 的 事项 ， 尤 其 是 
与 集合 有 关 的 情况 。 别 忘 了 你 可 以 用 数组 括号 表示 法 来 选择 集合 中 具有 
特定 索引 值 的 元 素 ， 甚 至 可 以 在 括号 中 置 入 算术 表达 式 。Hibernate 人 参考 
手册 的 HQL 那 一 章 在 元 长 的 示例 之 后 ， 接 着 的 一 节 是 “小 技巧 和 小 窗 
`J” (Tips and Tricks) ， 这 一 节 给 出 了 一 些 有 用 的 建议 ， 谈 到 了 如 何在 
不 同 数据 库 环境 中 有 效 地 工作 ， 以 及 使 用 各 种 Hibernate 接 口 来 达到 你 想 
都 想不到 的 效果 (如 果 你 有 SQL 使 用 基础 ， 就 更 是 如 此 〉。 你 也 可 以 和 仔 
细 研 读本 书 附录 E 提 到 的 那些 图 书 。 和 希望 这 里 的 讨论 能 够 帮助 你 商定 好 
基础 ， 并 能 作为 日 后 探索 研究 的 出 发 点 、 文 柱 以 及 动机 ! 





注意 : 这 不 是 你 老区 那个 时 代 的 SQL...... 


[1] 
http://www.hibernate.org/hib_docs/v3/reference/en/html_single/#sp_query. 


[2] http://www.hibernate.org/hib_docs/v3/treference/en/html/queryhql.html. 





第 二 部 分 与 其 他 工具 的 集成 


到 目前 为 止 ， 我们 的 示例 只 涉及 除 Hibernate 以 外 非常 有 限 的 一 组 工 
H: Ant, Maven Ant Tasks, Hibernate Tools 以 及 我 们 的 关系 数据 库 
HSQLDB。 为 我 们 快速 地 “品尝 ”Hibernate 并 体验 它 的 主要 功能 而 提供 一 
个 平台 ， 这 些 工具 再 合适 不 过 了 。 不 过 ， 在 现实 世界 中 ， 你 可 能 经 常会 
需要 以 不 同 的 方式 来 使 用 Hibernate， 并 与 其 他 有 用 的 工具 包 配 合 使 用 。 


幸好 ， 这 些 工 具 的 用 法 还 算 简 单 ! 所 以 我 们 换个 方向 ， 开 始 介绍 一 
些 新 面孔 ， 比 如 流行 的 MySQL 数 据 库 和 Eclipse IDE “集成 开发 环境 ) 。 
接着 我 们 将 更 深入 地 讨论 Maven， 而 不 是 像 原 来 那样 ， 只 是 将 它 作为 让 
示例 可 以 正常 工作 的 一 块 跳板 ， 演 示 了 一 些 比 Ant Tasks 更 为 有 用 的 
Maven 用 法 。 最 后 ， 我 们 将 重点 介绍 Spring 和 Stripes， 这 是 两 个 非常 有 


用 的 开源 项 目 ， 与 Hibernate 结 合 得 相当 完美 。 











第 10 章 ”将 Hibernate 连 接 到 MySQL 


建立 MySQL 数 据 库 


虽然 HSQLDB 是 一 个 漂亮 的 、 完 整 的 (self-contained〉 数据 库 ， 不 
过 你 的 实际 项 目 可 能 并 不 需要 这 种 租 入 式 的 Java 数 据 库 。 事 实 上 ， 你 更 
可 能 需要 同 某 些 现 有 的 、 外 部 的 数据 库 打交道 。 幸 好 ， 这 也 没什么 困难 
的 《假设 你 已 经 安装 好 了 数据 库 ， 并 可 以 让 它 正 常 运行 起 来 ， 不 过 ， 这 
些 〈 安 装 和 配置 ) 内 容 肯定 不 在 本 书 讨论 的 范围 之 内 ) 。 


© 





注意 : 这 个 例子 假设 你 已 经 有 了 一 个 可 运行 的 MYSQL 实例， 可 以 


THE, 


me 


为 了 突出 Hibernate 在 数据 库 选 择 上 的 灵活 性 ， 我 们 先 来 看 看 如 果 想 
让 Hibernate 连 接 到 MySQL 数 据 库 ， 应 该 怎么 修改 第 2 章 中 Hibernate 的 配 
置 。 


应 该 怎么 做 


连接 到 MySQL 服 务 器 ， 创 建 一 个 新 的 数据 库 ， 如 例 10-1 所 示 。 


例 10-1: 建立 MySQL 数 据 库 notebook _db 





%gmysql-u root-p 
Enter password: 
elcome to the MySQL monitor.Commands end with; or\g. 
Your MySQL connection id is 3 to server version: 5.0.21 
Type'thelp; 'or'\h'for help.Type'\c'to clear the buffer. 
mysql>CREATE DATABASE notebook db; 
Query OK, 1 row affected (0.03 sec) 
mysql >GRANT ALL ON 
notebook db.*TO'jim'@'janus.reseune.pvt' IDENTIFIED 
BY's3cret'; 
Query OK, 0 rows affected (0.02 sec) 
mysql>quit; 
Bye 





































































































注意 一 下 你 创建 的 数据 库 的 名 称 ， 以 及 授予 能 够 访问 它 的 用 户 名 和 
口令 ， 需 要 将 这 些 信息 输入 到 hibernate.cfg.xml 配 置 文件 中 ， 如 稍 后 的 例 
10-3 所 示 〔 在 实际 的 数据 库 使 用 中 ,希望 你 使 用 比 这 个 例子 的 口令 更 为 
健壮 的 口令 ) 。 如 果 你 的 数据 库 服务 器 与 运行 示例 代码 的 计算 机 不 是 同 
一 侣 机器， 那么 需要 将 GRANT 命令 行 中 的 localhost 符 换 为 用 于 运行 示例 
的 机 器 的 主机 名 《或 者 ， 如 果 你 是 在 一 个 相对 安全 的 私有 网 络 中 ， 那 么 
还 可 以 使 用 “9%? 来 表示 容许 接受 任何 主机 的 访问 ) 。 





连接 到 MySQL 


接 下 来 ， 我 们 需要 用 一 个 JDBC 了 驱动 程序 才能 够 连接 到 MySQL。 为 
了 获取 这 个 驱动 程序 ， 可 以 在 build.xml 中 再 添加 一 个 依赖 ， 如 例 10-2 所 
示 。 对 于 几 种 不 同 的 数据 库 ， 都 有 它们 各 自 可 供 使 用 的 驱动 程序 ， 这 一 
点 不 错 。 这 些 不 同 的 驱动 程序 不 会 冲突 ， 因 为 Hibernate 配 置 文件 会 指定 
最 终 使 用 哪个 驱动 程序 (如 果 你 对 如 何 “ 手 工 ” 获 取 这 种 驱动 程序 感到 好 
奇 ， 那 么 可 以 从 MySQL 的 官方 网 站 (1 ) 下载 Connector/J) 。 不 过 ， 
如 果 你 想 避 免 以 后 Hibernate 配 置 文件 的 读者 会 感到 这 部 分 有 些 混乱 ， 则 
可 以 放心 地 删除 <hsqldb> 依 赖 和 <db> 构 建 目 标 ， 因 为 以 后 不 再 需要 
用 GUI (图形 用 户 界面 ) 查看 HSQLDB 中 的 数据 了 。 














例 10-2: 在 build.xml 中 添加 对 MySQL 驱动 程 序 的 项 目 依赖 





<artifact: dependencies pathId="dependency.class.path"> 
<dependency groupid="hsqldb"artifactId="hsgqldb"version="1.8.0.7"/ 























<dependency groupId="mysql"artifactId="mysql-connector-java" 
version="5.0.5"/> 
<dependency groupId="o0rg.hibernate"artifactId="hibernate" 
version="3.2.5.ga"> 





























说 到 配置 文件 ， 现 在 就 应 该 编辑 hibernate.cfg.xml， 以 使 用 新 的 驱动 
程序 和 我 们 刚才 创建 的 数据 库 了 。 例 10-3 演 示 了 如 何 使 用 前 面 例 10-1 创 


建 的 数据 来 建立 到 我 自己 的 MySQL 数 据 库 实 例 的 连接 。 你 需要 根据 你 
自己 的 数据 库 服 务 器 、 数 据 库 以 及 你 所 选择 的 登录 身份 认证 来 调整 这 些 
数据 库 连 接 的 配置 值 《如果 你 使 用 的 是 MM.MySQL， 则 应 该 使 用 旧版 
的 MySQL JDBC 了 驱动 程序 ， 相 应 的 驱动 程序 类 名 称 应 该 是 





com.mysql.jdbc.Driver) 。 


还 需要 删除 配置 文件 底部 的 jdbc.batch_size 属 性 。 报 告 来 自 批 处 理 内 
的 实际 问题 ，MySQL 驱 动 程 序 没有 任何 问题 ， 与 进程 外 (out-of- 
process) 数据 库 相 比 ， 对 于 前 面 使 用 的 HSQLDB 了 驱动 程序 ， 如 果 关 闭 这 
个 批 处 理 选 项 ， 则 会 对 性 能 造成 很 大 的 不 民 影 响 。 





例 10-3: 修改 hibernate.cfg.xml 以 连接 到 新 的 MySQL 数 据 库 








<?xml version='1.0'encoding='utf-8'?> 

<! DOCTYPE hibernate-configuration PUBLIC 

"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 

"http://hibernate. sourceforge.net/hibernate-configuration- 
3.0.dtd"> 

<hibernate-configuration> 

<session-factory> 

<! --SQL dialect--> 

<property name="dialect">org.hibernate.dialect .MySQL5Dialect 
</property> 

<! --Database connection settings--> 

<property name="connection.driver class">com.mysql.jdbc.Driver 
</property> 

<property 

name="connection.url">jdbc: mysql: //localhost/notebook db 
</property> 

<property name="connection.username">jim</property> 

<property name="connection.password">s3cret</property> 

<property name="connection. shutdown" >true</property> 



























































如 果 不 是 在 运行 测试 示例 的 机 器 上 运行 MySQL， 而 是 在 另外 的 机 
器 上 运行 MySQL， 则 第 三 个 属性 定义 必须 能 够 反映 出 你 的 数据 库 服务 
器 的 名 称 。 另 外 ，connection.shutdown 配 置 属性 也 不 再 需要 了 ， 不 过 ， 
放 在 那里 也 没什么 影 啊 。 





[1] http:/ /www.mysgl.com/products/connector/j/. 


Zit 


一 切 准备 好 以 后 ， 再 回 到 第 2.3 节 建立 的 那个 数据 库 模式 创建 的 示 
例 。 这 一 次 它 应 该 在 MySQL 服 务 器 上 创建 数据 库 模 式 ， 而 不 是 在 租 入 
式 HSQLDB 中 。 数 据 库 模式 创建 的 输出 如 例 10-4 所 示 ， 不 过 ， 实 际 输出 
的 内 容 要 比 这 个 例子 列举 的 内 容 还 要 长 ， 所 以 就 删除 了 部 分 重复 和 繁琐 
的 输出 ， 以 突出 一 些 特别 重要 的 片段 ， 通 过 它们 来 证 明 我 们 的 新 设置 已 
经 生效 了 注意， 我 们 以 一 个 单独 的 ant prepare 调 用 作为 开始 ， 因 为 这 
是 我 们 第 一 次 在 本 章 的 示例 目录 运行 程序 ， 在 Ant 第 一 次 开始 运行 
schema 构 建 目 标 时 ， 我 们 需要 将 正确 的 文件 放 在 类 路 径 上 ) 。 














例 10-4: 连接 MySQL 并 创建 数据 库 模 式 





Sant prepare 
Buildfile: build.xml 
Downloading: mysql/mysgql-connector-java/5.0.5/mysql-connector- 
java-5.0.5.pom 
Transferring 1K 
Downloading: mysql/mysgql-connector-java/5.0.5/mysql-connector- 
java-5.0.5.Jjar 
Transferring 500K 
prepare: 
[mkdir]Created 
dir: /Users/jim/svn/oreilly/hibernate/current/examples 
/chl10/classes 
[copy]Copying 5 files to/Users/jim/svn/oreilly/hibernate/current 
/examples/chl10/classes 
BUILD SUCCESSFUL 
Total time: 3 seconds 
Sant schema 
Buildfile: build.xml 





















































usertypes: 
[javac]Compiling 2 source 
/current/examp 
codegen: 
[hibernatetool] 
Configuration 
[hibernatetool]]1 
[hibernatetool]16: 
S205 
[hibernatetool]16: 
hibernate.properties 
not found 
[hibernatetool]16: 
provider name 
cglib 
[hibernatetool]16: 
java. 
sql.Timestamp handling 
[hibernatetool]16: 
from 
file: hibernate.cf 
[hibernatetool]16: 
mappings 
from resource: 
[hibernatetool]16: 


com 


prepare: 































































































.task: 


46: 





46: 


46: 








38; 


38; 


38; 


46: 38, 


46: 38, 
g.xml 


46: 38, 





403 





415 





NFO 














NFO 


Environment: 





419 








NFO 





Environment: 





434 


561 


740 








NFO 





Environment: 





INFO 





Con 





INFO Con 





figura 


hbm2java (Generates a set of 
Environment: 





tion: 





JExecuting Hibernate Tool with a Standard 








681- 


.java 


files to/Users/jim/svn/oreilly/hibernate 
les/ch10/classes 


files) 





547- 





1460-con 








figura 





tion: 


com/oreilly/hh/data/Track.hbm. xml 


46: 38, 


932 





.oreilly.hh.data.Track->TRACK 


[hibernatetool]16: 


collection: 





[hibernatetool]16: 46: 39, 239 INFO Conf 
SessionFactor 

y: null 

[hibernatetool]16: 46: 39, 411 INFO Version: 
315 2310- 5.9 

compile: 

[javac]Compiling 9 source fil 

/current/examples/ch10/classes 

schema: 

[hibernatetool]E 
Configuration 

[hibernatetool]1. 

[hibernatetool]16: 46: 41, 502 INFO Con 
from 

file: hibernate.cfg.xml 

[hibernatetool]16: 46: 41, 515 INFO Con 


com. orel lly: hh, data,Arlist. beacks=-TRACK ARTI 
iguration: 




































































46: 39, 


110 


























INFO Hbml 


Binder: 





INFO Hbml 


Binder: 











STS 


514-Hibernat 


Bytecode 


598-using JDK 1.4 





figuring 


553-Reading 


1422-Mapping 


1541-Conf 


300-Mapping class: 





igured 








15-Hibernate Tools 


es to/Users/jim/svn/oreilly/hibernate 





xecuting Hibernate Tool with a Standard 


task: hbm2ddl (Generates database schema) 
































fi gurat 


ion: 


1460-con 








figura 





tion: 





figuring 


553-Reading 


mappings 






























































from resource: com/oreilly/hh/data/Track.hbm. xml 

[hibernatetool]16: 46: 41, 629 INFO Configuration: 1541-Configured 
SessionFactor 

y: null 

[hibernatetool]16: 46: 41, 659 INFO Dialect: 152-Using dialect: 





org.hibernate 
-dialect .MySQL5Dialect 
[hibernatetool]16: 46: 41, 714 INFO SchemaExport: 154-Running 
hbm2dd1 
schema export 
































[hibernatetool]16: 46: 41, 716 INFO SchemaExport: 179-exporting 
generated 

schema to database 

[hibernatetool]16: 46: 41, 725 INFO 
































DriverManagerConnectionProvider: 41-Using 

Hibernate built-in connection pool (not for production use! ) 
[hibernatetool]16: 46: 41, 726 INFO 
DriverManagerConnectionProvider: 42-Hibernat 
e connection pool size: 1 
[hibernatetool]16: 46: 41, 727 INFO 
DriverManagerConnectionProvider: 45-autocomm 
it mode: false 
[hibernatetool]16: 46: 41, 745 INFO 
DriverManagerConnectionProvider: 80-using 

driver: com.mysql.jdbc.Driver at URL: jdbc: 
mysql: //localhost/notebook db 

[hibernatetool]16: 46: 41, 746 INFO 
DriverManagerConnectionProvider: 86- 

connection properties: {user=jim, password=****, shutdown=true } 

[hibernatetool]alter table ALBUM ARTISTS drop foreign key 
FK7BA403FC76BBFFEF9; 















































































































































































































































[hibernatetool]Jalter table TRACK COMMENTS drop foreign key 
FK105B2688E424525B; 
[hibernatetool]drop table if exists ALBUM; 
[hibernatetool]drop table if exists ALBUM ARTISTS; 
[hibernatetool]drop table if exists ALBUM COMMENTS; 
[hibernatetool]drop table if exists ALBUM TRACKS; 
[hibernatetool]drop table if exists ARTIST; 
[hibernatetool]drop table if exists TRACK; 
[hibernatetool]drop table if exists TRACK ARTISTS; 
[hibernatetool]drop table if exists TRACK COMMENTS; 
[hibernatetool]create table ALBUM (ALBUM ID integer not null 








auto increment, TI 
TLE varchar (255) not null, numDiscs integer, added date, primary 
key (ALBUM ID) ) 

















null, ARTIST ID 


nul 


nul 


auto increment, TI 


playTime time, 


. 
9 

















[hibernatetool]create table ALBUM ARTISTS (ALBUM ID integer not 

















integer not null, primary key (ALBUM ID, ARTIST ID) ) ; 
[hibernatetool]create table ALBUM COMMENTS (ALBUM ID integer not 





1, COMMENT 








varchar (255) ) ; 











l, TRACK ID 






































[hibernatetool]create table ALBUM TRACKS (ALBUM ID integer not 

















integer, disc integer, positionOnDisc integer, LIST POS integer 
not null, primary 

















key (ALBUM _ID, I 


ST POS) ) ; 





[hibernatetool]create table ARTIST (ARTIST ID integer not null 
auto increment, 
NAME varchar (255) not null unique, actualArtist integer, primary 
key (ARTIST ID) 

















) ; 














[hibernatetool]create table TRACK (TRACK ID integer not null 











TLE varchar (255) not null, filePath varchar (255) not null, 





added 


date, VOL LEFT smallint, VOL RIGHT smallint, sourceMedia 
varchar (255) , 





primary key (TRACK ID) ) ; 

















[hibernatetool]create table TRACK ARTISTS (TRACK ID integer not 
null, ARTIST ID 
integer not null, primary key (TRACK ID, ARTIST ID) ); 

[hibernatetool]create table TRACK COMMENTS (TRACK ID integer not 
null, COMMENT 




















varchar (255) ) ; 
































[hibernatetool]create index ALBUM TITLE on ALBUM (TITLE) ; 
[hibernatetool]alter table ALBUM ARTISTS add index 


















































FK7BA403FC76BBFFF9 (ARTIST ID) , 
add constraint FK7BA403FC76BBFFF9 foreign key (ARTIST ID) 


Ee 























ferences ARTIST 





(ARTIST ID) ; 












































[hibernatetool]Jalter table ALBUM ARTISTS add index 











FK7BA403FCF2AD8FDB (ALBUM ID) , 


ES 


FRKIE2C21E4F2AD8FDB 




















add constraint FK7BA403FCF2AD8FD! 
ferences ALBUM 








(ALBUM ID) ; 











UJ 











foreign key (ALBUM ID) 














[hibernatetool]alter table ALBUM COMMENTS add index 



































(ALBUM ID) , add constraint FKIE2C21E4F2AD8FDB foreign 





























key (ALBUM ID) references 


FKD1ICBBC78E424525B 








ALBUM (ALBUM ID) 




















9 


[hibernatetool]alter table ALBUM TRACKS add index 
































(TRACK _ 
key (TRACK 1 














TRACK (TRACK ID) ; 


[hibernatetool 
BC78F2AD8FDB 


FKDICB 











(ALBUM 


key (ALI 





ID), add constraint FKDICBBC78E424525B foreign 
[D) references 


























lalter table ALBUM TRACKS add index 

















BUM | 








ALBU 




















ID), add constraint FKD1C] 
[D) references 
M (ALBUM_ID) ; 








UJ 











BC78F2AD8FDB foreign 











[hibernatetool]create index ARTIST_NAME on ARTIST (NAME) ; 
[hibernatetool]alter table ARTIST add index 


FK7395D347A1422D3] 
add consi 





refere 


nces 















































B CactualArtist) ， 
traint FK7395D347A1422D3B foreign key (actualArtist) 














ARTIST (ARTIST ID) ; 


[hibernatetool]create index TRACK TITLE on TRACK (TITLE) ; 
[hibernatetool]Jalter table TRACK ARTISTS add index 

DAD8E424525B 
ID) , add constraint FK72EFDAD8E424525B foreign 


[D) references 


FK72EF 





(TRACK _ 
key (TRACK 1 

































































TRACK (TRACK ID) ; 


[hibernatetool 
































FK72EFDAD87 6BBFFF9 





CART 














ST 











key (ARTIST 
references ARTIST ( Zz 
[hibernatetool]alter table TRACK COMMENTS add index 





FK105B2688E424525B 











D) 














Jalter table TRACK ARTISTS add index 

















D), add constraint FK72EFDAD876BBFFF9 foreign 





ARTIST ID) ; 














E 






























































[D) , add constraint FK105B2688E424525B foreign 


6: 42, 630 INFO SchemaExport: 196-schema export 








(TRACK ] 
key (TRACK _ID) references 
TRACK (TRACK_ID) ; 
[hibernatetool]16: 
complete 
[hibernatetool]16: 





























6: 42, 631 INFO 





DriverManagerConnectionProvider: 147-cleanin 
g up connection pool: jdbc: mysql: //localhost/notebook db 
[hibernatetool]9 errors occurred while performing<hbm2ddl>. 
[hibernatetool]Error#1: 


com.mysql.j 
able'not 
[hibe 
com.mysql.j 
able'not 


ab] 


[hibernatetool]] 
com.mysql.j 





le'not 



































dbc.excepti 





dbc.excepti 





dbc.excepti 
tebook db.al 





dbc.excepti 








abl 


le'not 


Error#1: 











ons.MySQLSyntaxErrorException: T 





tebook db.album artists'doesn't exist 
rnatetool]! 











ons.MySQLSyntaxErrorException: T 





tebook db.album artists'doesn't exist 
[hibernatetool]! 
com.mysql.j 


Error#1: 














ons.MySQLSyntaxErrorException: T 
lbum_comments'doesn't exist 


Error#1: 











ons.MySQLSyntaxErrorException: T 








tebook db.al 


lbum_tracks'doesn't exist 





[hibernatetool]Error#1: 
com.mysql.jdbc.exceptions.MySOQLSyntaxErrorException: T 
able'notebook db.album tracks'doesn't exist 
[hibernatetool]Error#1: 
com.mysql.jdbc.exceptions.MySOQLSyntaxErrorException: T 
able'notebook db.artist'doesn't exist 
[hibernatetool]Error#l: 
com.mysql.jdbc.exceptions.MySOLSyntaxErrorException: T 
able'notebook db.track artists'doesn't exist 
[hibernatetool]Error#l: 
com.mysql.jdbc.exceptions.MySOQLSyntaxErrorException: T 
able'notebook db.track artists'doesn't exist 
[hibernatetool]Error#1: 
com.mysql.jdbc.exceptions.MySOQLSyntaxErrorException: T 
able'notebook db.track comments'doesn't exist 
BUILD SUCCESSFUL 
Total time: 8 seconds 


























































































































KETTA 


Hibernate 会 自行 配置 和 使 用 MySQL 的 特定 功能 ， 检 查 我 们 的 Track 
类 的 映射 文档 ， 连 接 到 MySQL 服 务 器 ， 执 行 必要 的 命令 以 创建 供 持 久 
化 我 们 的 示例 数据 所 需要 的 数据 库 模式 (和 以 前 一 样 ， 最 后 会 报告 儿 个 
SQL 异 常 ， 你 可 以 忽略 它们 ;这 些 异常 可 能 是 因为 Hibernate 试 图 删除 并 


不 存在 的 外 键 而 引起 的 ， 因 为 这 是 我 们 首次 答 试 创建 数据 库 模 式 ) 。 








再 次 说 明 一 下 ， 不 必 担 心 最 后 出 现 的 错误 ， 这 些 错误 是 由 于 为 了 防 
止 已 经 存在 部 分 数据 库 模 式 ，Hibernate 抢 先 试 图 删除 它们 而 造成 的 。 即 
便 报 告 有 错误 ，Hibernate 并 不 认为 它们 会 造成 问题 ， 所 以 继续 处 理 剩 下 
的 数据 库 模 式 创建 任务 ， 并 最 终 报告 操作 成 功 完 成 。 


把 这 个 示例 和 HSQLDB 版 本 的 数据 库 模 式 创 建 〈 例 2-7) 进行 比 
较 ， 结 果 会 很 有 趣 。 它 们 的 输出 又 不 多 是 相同 的 ， 但 是 用 于 创建 数据 库 
表 的 SQL 语句 明显 不 同 。 这 就 是 Hibernate 中 所 谓 的 SQL“ 方 言 。 








A 





A TERSA PRA WS {FMySQLe PF vin, MAGA 
创建 好 了 Track 类 映射 的 数据 库 模 式 ， 结 果 如 例 10-5 所 示 。 


例 10-5: 检查 新 创建 的 MySQL 数 据 库 模式 


* mysql =u jim =p 

Enter password: 

Welcome to the MySQL monitor. Commands end with ; or \g. 
Your MySQL connection id is 21 to server version: 5.0.27 


Type ‘help;' or VM for help. Type '\c' to clear the buffer. 


mysql> use notebook_db 

Reading table information for completion of table and column names 
You can turn off this feature to get a quicker startup with -A 
Database changed 


mysql> show tables; 


| ALBUM_ARTISTS | 
| ALBUM_COMMENTS | 
| ALBUM_TRACKS | 
| ARTIST | 
| TRACK_ARTISTS | 
| TRACK_COMMENTS | 
| album | 
| | 


8 rows in set (0.00 sec) 


mysql> describe track; 


十 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
| Field | Type | Null | Key | Default | Extra 

二 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 + 一 一 一 一 一 一 十 一 一 一 一 一 +--------- 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
| TRACK_ID | Ent} | NO | PRI | NULL | auto_increment 
i SEAR | varchar(255) | NO | MUL | | 

| filePath | varchar(255) | NO | | | 

| | | | | | 


playTime time 


























added date | YES | NULL | | 
| VOL_LEFT smallint (6) | YES | NULL | 
VOL_RIGHT | smallint (6) | YES | NULL | | 
sourceMedia | varchar(255) | YES | NULL | | 
二 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 
8 rows in set (0.03 sec) 
mysql> select * from TRACK; 
Empty set (0.00 sec) 
mysql> describe album_tracks; 
十 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 十 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 十 
Field Type Null Key Default Extra 
= = a 十 一 - 十 一 一 一 一 一 一 一 一 一 十 十 
| ALBUM_ID int (11) NO PRI | 
TRACK_ID dnt ps Bs YES MUL NULL 
| disc int (11) YES | NULL 
positionOnDisc int (11) YES NULL 
LIST_FPOS int (11) NO PRI | 
-= 一 十 一 一 一 +- —-+ -= + E 


5 rows in set (0.00 sec) 


mysql> quit; 
Bye 


发 现 数据 表 是 空 的 ， 这 并 不 奇怪 。 如 果 你 从 示例 所 在 的 目录 中 运行 
ant ctest 命 令 ， 接 着 再 尝试 做 个 select 查 询 ， 将 会 看 到 类 似 例 10-6 所 示 的 
数据 。 只 需要 修改 一 个 Hibernate 使 用 的 配置 文件 ， 就 可 以 完全 切换 所 使 
用 的 数据 库 。 当 项 目 进行 中 客户 多 次 提出 要 改变 他 们 需要 的 数据 来 源 
时 ， 或 是 多 位 开发 人 员 各 自 喜 欢 使 用 不 同 的 操作 系统 时 ， 以 这 种 方式 来 
修改 配置 显得 非常 方便 。 











例 10-6: 在 运行 ctest 构 建 目标 后 ， 碍 询 TRACK 数 据 库 表 


mysql> select * from track; 


























一 一 十 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 十 
TRACK_ID | TITLE | filePath 
| playTime | added | VOL_LEFT | VOL_RIGHT | sourceMedia | 
十 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
一 一 十 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 + 
1 Russian Trance vol2/album610/track02.mp 
3 00:03:30 | 2007-09-22 100 100 CD 
2 Video Killed the Radio Star vol2/album611/track12.mp 
3 00:03:49 | 2007-09-22 100 100 VHS 
3 Gravity's Angel vol2/album175/track03.mp 
3 00:06:06 | 2007-09-22 100 100 CD 
4 Adagio for Strings (Ferry Corsten Remix) vol2/album972/track01.mp 
3 00:06:35 | 2007-09-22 100 100 CD 
5 Adagio for Strings (ATB Remix) vol2/album972/track02.mp 
3 00:07:39 | 2007-09-22 100 100 CD 
6 The World '99 vol2/singles/pvw99.mp3 
00:07:05 | 2007-09-22 100 100 STREAM 
| 7 | Test Tone 1 | vol2/singles/test01.mp3 
| 00:00:10 | 2007-09-22 | 50 | 75 | NULL 
十 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
一 一 十 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 + 


7 rows in set (0.00 sec) 


其 他 


在 图 形 界面 中 使 用 MySQL? 如 果 你 喜欢 使 用 像 我 们 在 演示 
HSQLDB 时 用 的 那 种 图 形 界面 工具 ， 可 以 试 试 MySQL GUI 工具 ， 可 以 
从 http://dev.mysql.com/downloads/gui-tools/5.0.html 下 载 它 。 








连接 到 Oracle 数 据 库 ， 或 其 他 你 喜欢 的 数据 库 ， 或 是 共享 的 、 遗 留 
的 数据 库 ， 总 之 不 是 MYSQL 或 HSQLDB 数 据 库 ? 你 可 能 已 经 想到 连接 
到 其 他 数据 库 也 同样 很 简单 ， 所 有 需要 做 的 就 是 修改 hibernate.cfg.xml 中 
的 pibernate.dialect 属 性 ， 以 反映 你 想 使 用 的 那 种 数据 库 。 可 供 选 用 的 数 








据 库 方言 有 许多 种 ， 差 不 多 已 经 包括 了 我 能 够 想得到 的 每 种 免费 的 和 商 
业 的 数据 库 。 附 录 C 列 出 了 在 编写 本 书 时 Hibernate 能 够 文 持 的 所 有 数据 
库 方言 ， 不 过 还 是 应 该 查阅 Hibernate 的 官方 文档 以 得 到 最 新 的 列表 。 如 
果 你 想 使 用 比较 冷 俱 的 数据 库 ， 那 可 能 就 得 目 己 编写 支持 它 的 数据 库 方 
言 了 ， 但 是 这 种 情况 看 起 来 不 太 可 能 发 生 《〈 了 最 好 移 查 得 是 否 已 经 有 人 开 
始 为 之 付出 努力 了 ) 。 




















在 选择 好 使 用 哪 种 数据 库 方言 以 后 ， 还 需要 正确 设置 
hibernate.connection 的 各 个 属性 (driver、URL、username 以 及 
password) ， 才 可 以 建立 连接 到 你 所 选择 的 数据 库 环 境 的 JDBC 连 接 。 
如 果 你 是 在 移植 现 有 的 项 目 以 使 用 Hibernate， 同 可 以 从 项 目的 代码 或 配 
置 中 得 到 这 些 信 息 。 而 且 自 然 地 ， 在 项 目 构建 和 运行 期 间 ， 必 须 提 供 项 
目 依 赖 的 JDBC 了 驱动 程序 。 


当然 ， 如 果 你 正在 连接 一 个 现 有 的 或 共享 的 数据 库 ， 就 不 必 使 用 
Hibernate 来 创建 数据 库 模 式 了 。 相 反 ， 这 时 你 需要 编写 Hibermate 映 射 文 
档 ， 以 便 将 现 有 的 数据 库 模式 映射 到 持久 化 类 。 这 一 步 可 以 手工 完成 ， 
或 者 使 用 Hibernate Tools 〈 我 们 将 在 第 11 章 深入 研究 这 一 工具 ) 的 帮 
助 ， 还 可 以 使 用 像 Middlegen (H) 之 类 的 第 三 方 工具 包 ， 之 后 就 可 以 
按 持 和 久 化 对 象 的 形式 来 使 用 数据 了 。 








使 用 Hibernate 甚 至 还 可 以 同时 与 多 种 不 同 的 数据 库 进 行 交 互 ， 只 需 
要 用 单独 的 配置 文件 来 创建 多 个 会 话 工厂 实例 。 这 样 的 使 用 方法 已 经 超 





出 了 本 书 所 要 演示 的 人 简单、 自动 化 的 配置 范围 ， 不 过 ，Hibernate 参 考 文 
档 中 有 这 方面 的 例子 。 当 然 ， 在 某 一 时 刻 ， 一 个 持久 化 对 象 只 能 与 一 个 
会 话 实 例 相 关联 ， 这 意味 着 一 个 持久 化 对 象 一 次 只 能 链接 到 一 个 数据 

库 。 不 过 ， 即 使 不 同 的 数据 库 使 用 不 同 的 模式 来 表示 持久 化 类 ， 还 是 可 
以 通过 精心 设计 的 编码 ， 实 现在 不 同 的 数据 库 系 统 之 间 复 制 或 移动 对 

象 。 当 然 ， 这 样 复杂 的 处 理 更 是 超出 本 书 的 讨论 范围 了 ! 








[1] http://boss.bekk.no/boss/middlegen/. 


第 11 章 ”Hibernate 与 Eclipse: Hibernate Tools 使 用 
实战 


在 Eclipse 中 安装 Hibernate Tools 


如 果 你 是 使 用 Eclipse 作 为 Java 开 发 环境 (现在 很 多 开发 人 员 痢 在 使 
HE (Ul) ) ， 和 本 书 其 他 部 分 对 这 一 工具 的 使 用 (我 们 原来 用 它 为 
Ant 构 建 处 理 增加 Hibernate 相 关 的 功能 ) 相 比 ， 在 Eclipse 中 可 以 更 加 充 
分 地 使 用 Hibernate Tools. 


应 该 怎么 做 


在 深入 讨论 以 前 ， 先 需要 保证 你 使 用 的 Eclipse 的 版 本 足够 新 。 目 前 
Hibernate Tools 的 发 行 版 本 至 少 需 要 Eclipse 3.3 和 和 WTP 2.0。 所 以 ， 如 果 
你 的 版 本 不 够 新 ， 没 有 理由 不 借 这 个 机 会 更 新 一 下 。 





在 Eclipse 中 安装 Hibernate Tools 最 简单 的 方法 就 是 通过 Eclipse 普通 
的 网 站 更 新 机 制 。 首 先 需要 告诉 Eclipse 到 哪 找 Hibernate Tools， 
在 "Software Update" 某 单 中 选择 "Find and Install" 荣 单项 ， 如 图 11-1 所 


ZN o 










Welcome 


(?) Help Contents 
2P Search 
Dynamic Help 


Key Assist... 
Tips and Tricks... 

4) Report Bug or Enhancement 
Cheat Sheets... 










OSL 


Software Updates 2 Find and Install... 
®© Manage Configuration 


图 11-1 Eclipse 的 更 新 功能 





我 们 现在 需要 安装 全 新 的 一 个 插件 ， 而 不 是 更 新 现 有 的 插件 ， 所 以 
在 接 下 来 的 窗口 中 应 该 选择 "Search for new features to install", HA 





击 "Next"。 


Eclipse 自己 不 会 自动 知道 Hibernate Tools 更 新 网 站 ， 所 以 我 们 需要 
告诉 它 到 哪 去 找 。 点 击 "New Remote Site"， 如 图 11-2 所 示 。 


ece Install 


Update sites to visit 
| Select update sites to visit while looking for new features. 


Sites to include in search: 


| @ Eclipse Modeling Framework (EMF) Updates 
日 Al Eclipse Modeling Framework Technologies (EMFT) U 
= Al Europa Discovery Site 
CO A] Model Developement Tools (MDT) Updates 
G 4 The Eclipse Project Updates 
E d] web Tools Platform (WTP) Updates 





Ed Ignore features not applicable to this environment 
DD Automatically select mirrors 





图 11-2 在 Eclipse 中 从 一 个 新 的 更 新 网 站 来 安装 插件 


输入 一 些 描述 性 的 文字 (如 "Hibernate Tools") ， 以 作为 新 的 更 新 
网 站 的 名 称 。Eclipse 现 在 需要 我 们 指定 更 新 网 站 的 URL， 如 稍 后 的 图 
11-4 所 示 。 我 们 必需 在 网 上 搜索 一 下 ， 才 能 找到 正确 的 更 新 URL。 


切换 到 Web 浏 览 器 ， 打 开 Hibernate 网 站 http://hibernate.org， 在 页 面 
左边 的 导航 菜单 中 点 击 "Hibernate Tools" (或 者 ， 你 也 可 以 直接 打开 





http://tools.hibernate.org 这 个 目录 链接 ) 。 在 打开 页 面 以 后 ， 可 以 看 看 有 
关 这 一 工具 的 介绍 ， 以 及 各 种 文档 链接 。 我 们 在 第 一 次 研究 怎么 把 这 个 
工具 安装 到 Eclipse 中 时 ， 还 花 了 些 时 间 ， 最 后 才 发 现 我 们 错过 了 一 直 要 
找 的 东西 : 在 Tools 页 面 上 原本 就 有 一 个 更 新 网 站 链接 。 将 这 个 链接 的 
URL 复 制 到 剪 切 板 ， 如 图 11-3 所 示 〈 在 链接 上 用 鼠标 右键 点 击 或 按 住 

Ctl 键 点 击 ， 就 可 以 打开 上 下 文 关联 菜单 )。 


Hibernate Tools for Eclipse and Ant 


Project Lead: Max R. Andersen 
Contributors: Mark Hobson, Marshall Culpepper, David Channon, Joe Hudson and others 
Latest release: 3.2.0.GA (What's New?) 

Release date: 12.12.2007 

Update site: Hibernate Tools only & JBoss Tools 

Nightly Build: JBoss Tools 
Documentation: Reference, Viewlets, Build & Contr 
Requirements: Eclipse WTP 3.3/2.x or Ant, Dece 


Open Link in New Window 
Open Link in New Tab 












Download Linked File 
Download Linked File As... 
Add Link to Bookmarks... 


for an overview of the Hibernate 2.x toolset), imple 
for integration into the build cycle. Hibernate Tools 
Studio. See the documentation and screenshots fori 





The following features are available within Eclipse: 





Copy Link 
Mapping Editor: An editor for Hibernate XML map 


3 in Elemen 
completion and syntax highlighting. The editor eve spect ent 


completion for class names, property/field names, tat 


图 11-3 # Hibernate Tools 更 新 的 网 站 URL 





如 果 你 仔细 观察 ， 可 能 会 注意 到 这 个 页 面 上 Hibernate Tools 的 版 本 
要 比 我 们 这 本 书 使 用 的 版 本 (3.2.0 Beta9a) 还 新 。 不 错 ， 你 现在 应 该 明 
白 像 Hibernate 这 样 大 型 开源 项 目 变化 得 太 快 了 ， 写 本 关于 它 的 书 有 多 么 
难 ! 在 编写 本 书 时 ，Hibernate Tools 的 稳定 版 本 才刚 推出 ，Maven 库 中 


还 未 提供 对 这 个 版 本 的 支持 ， 所 以 我 们 现在 先 不 用 管 本 书 原来 使 用 的 
Hibernate Tools。 无 论 如 何 ， 新 版 本 的 变化 都 不 会 影响 其 他 章 市 的 示 
例 ， 只 是 Eclipse 的 当前 最 新 版 本 编写 本 书 时 的 版 本 是 3.3， 也 称 为 
Europa) 需要 配合 使 用 Hibernate Tools 的 最 新 版 本 ， 这 样 才 可 以 支持 本 


章 将 要 演示 的 一 些 功 能 。 


将 更 新 网 站 的 URE 复 制 粘贴 到 Eclipse 的 "New Update Site" 窗 口中 ， 
如 图 11-4 所 示 。 点 击 "OK" 按 钮 ， 以 确认 保存 这 个 新 的 网 站 URL。 


@20 





New Update Site 


Name: Hibernate Tools 


URL: wtp://download.jboss.org/jbosstools/updates/ stable 


© C E 


图 11-4 在 Eclipse 中 配置 一 个 新 的 更 新 网 站 


从 图 11-5 中 可 以 看 到 ，Eclipse 合 理 地 假设 你 想 使 用 刚才 配置 的 更 新 
网 站 ( 义 选 了 Hibernate Tools) ， 所 以 ， 这 时 只 要 点 击 "Finish" 按 钮 ， 
Eclipse 就 会 目 动 连接 更 新 网 站 ， 检 查 从 那 可 以 安装 的 插件 。 





接着 会 弹出 一 个 窗口 (如 图 11-6 所 示 )〉 ， 这 个 窗口 比较 简单 ， 它 的 
出 现 就 表明 胜利 在 望 了 。 所 有 我 们 需要 做 的 就 是 勾 选 Hibernate Tools 节 
ASW SNE, Pee, wn? 
© install 


Update sites to visit 
Select update sites to visit while looking for new features. 








Sites to include in search: 


[] & Eclipse Modeling Framework (EMF) Updates 
口 Al Eclipse Modeling Framework Technologies (EMFT) U! 
@] Europa Discovery Site | 


= 
v H| Hibernate Tools 

0o z] Model Developement Tools (MOT) Updates 
日 

日 


al The Eclipse Project Updates 
E Web Tools Platform (WTP) Updates 





图 11-5 新 的 更 新 网 站 已 经 准备 好 使 用 





@08e Updates 


Search Results 


€ SeamTools Feature (2.0.0.GA) requires feature 
“org.eclipse.datatools.connectivity.feature”. 


Select the features to install: 
I Hibernate Tools 





Error Details... 


10 of 10 selected. 
Vv Show the latest version of a feature only 
[| Filter features included in other features on the list 





图 11-6 正在 安装 Hibetrnate Tools: 我 们 需要 再 接 再 厉 


很 不 走运 ， 当 我 们 选中 Hibernate Tools 节 点 旁边 的 复 选 杠 时， 过 到 
了 有 乒 烦 。 这 个 窗口 顶部 显示 了 一 条 错误 消息 ，"Next" 按 钮 也 变 成 了 灰 
色 ， 不 让 我 们 继续 使 用 了 。 


出 了 什么 问题 


Eclipse 不 让 我 们 继续 安装 ， 是 因为 SeamTools 功 能 〈 组 成 Hibernate 
Tools 工 具 集 的 10 个 插件 之 一 ) 需要 安装 其 他 插件 
Corg.eclipse.datatools.connectivity.feature) ， 而 且 这 些 插件 还 不 能 默认 
安装 。 非 常 不 季 ， 我 们 只 得 后 退 几 步 。 点 击 "Cancel" 按 钮 ， 再 从 本 节 开 
台 介 绍 的 "Find and Install" 菜 单 选 项 开始 。 再 一 次 选择 "Search for new 
features to install"， 点 击 "Next"。 这 次 要 选中 Europa Discovery Site 节 点 ， 
如 图 11-7 所 示 ， 再 点 击 "Finish" 按 钮 。 





aoe Install 
Update sites to visit 
Select update sites to visit while looking for new features. 





Sites to include in search: 


| Eclipse Modeling Framework (EMF) Updates 
器 @] Eclipse Modeling Framework Technologies (EMFT) Updates 
iw | Europa Discovery Site 
Ed 圳 Hibernate Tools 
C) 4| Mode! Developement Tools (MOT) Updates 
问 A The Eclipse Project Updates 


New Archived Site... 


器 @ web Tools Platform (WTP) Updates 


Edit... 


Remove 





图 11-7 选中 Eclipse Discovery Site 


从 接 下 来 出 现 的 下 载 镜像 列表 中 选择 一 个 与 你 的 位 置 合适 的 选项 ， 
点 击 "OK'" 按 钮 《如 果 你 配置 Eclipse 自动 选择 下 载 镜像 ， 则 不 会 出 现 这 


一 步 ) 。 这 一 次 你 将 看 到 两 组 插件 : Europa Discovery Site#! Hibernate 
Tools。 再 次 选择 Hibernate Tools 这 组 插件 来 安装 。 和 以 前 一 样 ， 窗 口 顶 
部 还 是 会 出 现 错误 提示 ， 但 是 这 次 我 们 有 机 会 可 以 修复 这 个 问题 。 一 种 
办 法 就 是 选择 整个 "Europa Discovery Site" 插 件 组 ， 但 是 这 样 的 下 载 量 将 
大 大 超过 我 们 实际 的 需要 ， 会 让 Eclipse 的 配置 变 得 过 于 庞大 。 








所 以 ， 我 们 得 规划 出 需要 从 Europa Discovery Site 节 点 下 载 的 最 少 的 
一 组 插件 。 保 持 Hibernate Tools 插 件 节点 为 选中 状态 ， 展 开 Europa 
Discovery Site 插 件 组 节点 ， 但 是 不 选中 任何 东西 。 虽 然 可 以 手工 查找 和 
选择 Hibernate Tools 报 告 需要 的 插件 ， 但 这 会 导致 大 量 繁琐 地 摸索 、 尝 
试 、 解 决 错误 ， 才 能 确切 地 明白 哪些 插件 的 组 合 才 能 让 我 们 需要 的 东西 
正常 工作 (我们 试验 时 ， 曾 经 找到 过 第 一 个 错误 中 提 及 的 提供 数据 工具 
连接 功能 的 插件 ， 不 过 ， 我 们 发 现 这 个 插件 也 有 它 自 己 要 依赖 的 其 他 插 
件 ， 看 来 这 个 插件 还 不 是 我 们 必需 的 惟一 插件 ) 。 就 在 我 们 摩拳擦掌 ， 
准备 详细 写 写 如 何 精确 选择 需要 下 载 的 插件 时 ， 我 们 注意 到 界面 右边 
的 "Select Required" 按 钮 ， 其 实 可 以 用 它 来 自动 选择 需要 的 所 有 插件 。 不 
过 ， 我 们 的 实验 表明 ， 只 有 当 你 第 一 次 打开 相应 网 站 〈 将 从 这 个 网 站 下 
载 你 需要 的 插件 ) 旁边 的 “打开 ”三 角形 节点 时 ，"Select Required" 按 钮 才 
会 起 作用 。 直 到 我 们 展开 "Europa Discovery site" 这 个 节点 以 前 ， 它 什么 
也 不 会 做 。 在 展开 这 个 节点 以 后 ， 点 击 "Select Required" 按 钮 会 自动 选择 
解决 依赖 错误 所 需要 的 插件 。 既 然 现在 你 已 经 选中 了 Hibernate Tools i 
Ñ, Europa Discovery site 广 点 也 展开 了 ， 那 就 点 击 一 下 "Select 














Required" 按 钮 吧 。 最 后 结果 应 该 类 似 于 图 11-8 所 示 ， 不 过 ， 要 下 载 安装 
的 插件 的 确切 个 数 将 依赖 于 原来 你 可 能 已 经 安装 过 的 插件 。 


eoe Updates 
Search Results 
f Select features to install from the search result list. 


| Europa Discovery Site PN 


> 000 Cand C++ Developement 


> 000 Charting and Reporting (More info) 


> O00 Communications 


> 000 Database Development | ( Properties ) 


p> 000 Enabling Features 





> 000 Graphical Editors and Frameworks || C Select Required 
000 = 
aie gale sep | | Error Details...) 


20 of 119 selected. 
了 Show the latest version of a feature only 
器 Filter features included in other features on the list 
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T —— —_—=__ 
<<) GE Cran 


图 11-8 选中 需要 的 所 有 插件 





这 次 不 会 再 有 任何 错误 消息 妨碍 我 们 安 闭 Hibernate Tools 了 ! 点 
击 "Next" 按 钮 ， 就 开始 安装 这 组 插件 ， 接 受 在 下 一 个 对 话 杠 中 的 许可 协 
议 ， 并 再 次 点 击 "Next"。 之 后 会 再 弹出 一 个 对 话 框 ， 同 你 显示 一 组 可 以 


选择 安装 的 可 选 功能 。 因 为 我 们 只 需要 Hibernate Tools 就 足够 了 了， 所 以 
在 Optional Features (可 选 功能 ) 对 话 框 中 直接 点 击 "Next" 按 钮 以 便 继续 
安装 我 们 需要 的 插件 。 默 认 的 安装 位 置 《有 具体 位 置 随 Eclipse 安装 位 置 的 
不 同 而 不 同 ) 差不多 总 古 不 错 的 ， 除 非 有 特殊 原因 才 需 要 设置 到 其 他 位 
置 ， 点 击 Installation CZ) 对 话 框 的 "Finish" 按 钮 ， 继 续 完成 插件 的 安 
装 。 





在 下 载 更 新 期 间 ，Update Manager (更 新 管理 器 ) 将 一 直 持 续 运 
行 。 最 后 ， 将 弹出 一 个 Feature Verification〔 功 能 确认 ) 对 话 框 。 对 于 正 
在 安装 的 每 个 功能 ， 这 个 对 话 框 将 报告 每 个 功能 是 否 具有 Eclipse 项 目 授 
权 的 机 构 颁 发 的 加 密 签 名 。 一 些 插件 具有 这 样 的 签名 ， 而 另 一 些 〈 像 
Hibernate Tools 本 身 ) 则 没有 有 效 的 签名 。 第 三 方 Edlipse 插 件 通常 都 是 
这 样 的 。Eclipse 只 是 对 这 种 情况 进行 警告 ,希望 确认 你 愿意 安装 其 他 网 
站 的 插件 。 因 为 我 信任 提供 要 下 载 的 插件 的 网 站 ， 所 以 全 部 都 确认 继续 
安装 。 如 果 你 也 像 我 这 样 〈 基 本 上 ， 如 果 你 想 使 用 Hibernate Tools, it 
得 信任 提供 这 些 插件 的 网 站 ) ， 就 只 需要 点 击 "Install" 按 钮 ， 以 继续 安 
装 某 个 插件 (如 果 你 不 想 对 每 个 插件 进行 确认 ， 可 以 点 击 "Install All" 按 
钮 ， 以 批量 接受 所 有 插件 ) 。Update Manager (更 新 管理 器 ) 会 继续 安 
装 。 在 安装 完 所 有 插件 后 ， 它 会 建议 你 重新 启动 Eclipse。 为 了 确保 安 
全 ， 点 击 "Yes" 按 钮 ， 等 待 Eclipse 重 新 启动 。 








现在 做 什么 








很 明显 ， 与 过 去 相 比 ，Eclipse 现 在 对 Hibernate 提 供 了 更 多 的 文 持 。 
Hibernate 配 置 文件 的 图 标 现在 包含 了 一 个 小 的 Hibernate 标 志 ， 双 击 这 个 
图 标 或 映射 文件 ， 会 打开 一 个 特殊 的 编辑 器 ， 在 这 个 编辑 器 中 创建 和 更 
新 Hibermate 映 射 文件 会 更 方便 ， 而 不 用 直接 处 理 底 层 的 XML (图 11- 
Oi % 





Hibernate Configuration 3.0 XML Editor 


- + Session Factory 


" 2 a nme ( 
和 出 Properties 


E dialect ~ Properties 

>} connection.dr name 

= conmection.ur dialect 

—) connmection.us connection.driver_class 

=? connection. connection.ur! 

=} connection.sh connection.username 

= connection. connection.password 

=> current_sessi connection.shutdown 

=) cache provide connection. pool size 

=) show_sal current_session_context_class 
y 出 Mappings cache.provider_class 

=) resource=¢0 show_sql 

=} resource=co 








=} resource=con 


+ Mappings 
8 Caches 


| tem 
resource=com/oreilly/hh/data/Trs 





Session Factory 


图 11-9 Hibernate 配置 文件 编辑 器 





TER: 这 样 就 不 用 像 在 源 代 码 视 图 下 ， 得 频繁 查阅 参考 文档 才 可 以 
编辑 了 ! 





当然 ， 如 果 你 觉得 直接 处 理 XML 更 高 效 ， 可 以 点 击 编辑 器 底部 
的 "Source"《〈 源 代码 ) 选项 页 ， 仍 然 可 以 查看 XML 。 在 源 代码 视图 中 编 
辑 时 ， 你 会 发 现 它 已 经 为 编辑 各 种 Hibernate 相 关 元 素 以 及 取 值 提供 了 辅 
助 完成 〈completion assistance) 的 功能 ， 如 图 11-10 所 示 。 这 并 不 是 
XML 编辑 器 普通 的 元 系 名 称 目 动 完成 功能 ， 普 通 目 动 完 成 只 是 通过 分 
析 XML DTD 实 现 的， 而 DID 缺乏 对 属性 名 称 的 足够 描述 ， 只 能 规定 些 
文本 规则 。 





<?xml wersion='1.8" encoding='utf-8"?> 
<!DOCTYPE hibernote-configuration PUBLIC 
"=//Hibernate/Hibernate Configuration DTD 3.8//EN" 
"http: //hibernate. sourceforge.net/hibernate-configuration-3.8.dtd"> 


<hibernate-configuration> 
<session-factory> 


<l=- SQL dialect --> 
<property name="d">org.hibernate.dialect .MySQLSDialect</property> 


default batch fetch size 


<l-- Database con gofauit catalog 


<property name="¢ Vproperty> 


了 default_entity_mode 
name="connect default_schema roperty> 
<property nome-"c dialect 
<property name="¢ k 
<property nome="¢ 


<!=- JDBC connect 
<property nome="¢ 





= Enohla dibag 


Session Factory [Security | Sou 








图 11-10 Hibernate 配置 文件 编辑 器 中 的 属性 名 称 自动 完成 功能 


你 可 以 使 用 普通 的 Eclipse 自 动 完成 组 合 键 (ControlSpace〉 来 打开 


相应 的 弹出 窗口 。 


映射 文档 编辑 器 如 图 11-11 所 示 。 这 两 个 编辑 器 看 起 来 功能 强大 也 
很 有 用 ; 值得 花 些 时 间 来 摘 明 白 它 们 的 工作 原理 和 功能 。 对 于 在 Eclipse 
中 使 用 Hibernate 来 说 ， 它 们 本 里 也 是 很 有 价值 的 工具 。 





Hibernate 3.0 XML Editor 


= Track.hbm 


¥ Ba Trackhbm.xml* 
y 朵 Classes 
e © com.oreilly. Table: |TRACK 
y @ Queries 
? com.oreilly.hh 
? com.oreilly.hh name 
y ? comoreilly.hh ae 
filePath 
@ track 
playTime 
artists 
added 
volume 
sourceMedia 
comments 


+ Properties 


+ Subclasses 


subclass info 





图 11-11 Hibernate 映射 编辑 器 


为 了 探索 用 Hibernate Tools 还 可 以 做 些 什 么 其 他 事 ， 首 先 要 在 项 目 
中 激活 它 。 如 果 你 是 从 一 个 新 项 目 开 始 的 ， 可 以 选择 先 创 建 一 个 新 的 


Hibernate 配 置 文件 。 如 果 你 是 从 一 个 现 有 的 Hibernate 项 目 开 始 的 《本 章 
我 们 就 是 这 样 做 的 ) ， 你 可 以 跳 过 这 一 步 ， 只 需要 创建 一 个 新 的 
Hibernate 控 制 台 (console) 就 可 以 了 。 


[1] http://www.oreillynet.com/onjava/blog/2004/06/ive_been_eclipsed.html. 


创建 一 个 Hibernate 控 制 台 配置 


在 项 目 浏览 器 中 选择 项 目 ， 选 择 File -New ,Other， 扩 展 由 工具 添 
加 的 Hibernate 节 点 〈 如 图 11-12) ， 选 择 Hibernate Console 
Configuration 〈 从 这 里 能 够 选择 创建 一 个 新 的 配置 文件 、XML 映 射 文件 
以 及 对 配置 文件 进行 逆向 工程 处 理 〈 本 书 不 介绍 这 个 主题 )》 ) 。 点 
击 "Next" 以 继续 为 项 目 安装 这 一 工具 。 


注意 : 如 果 你 仍然 还 在 使 用 旧 的 properties 属 性 文件 来 配置 
Hibernate， 则 可 以 使 用 这 个 例子 上 面 的 "Property file". 


Select a wizard 
Creates a new Hibernate Console Configuration 


> (> General 
> (> CVS 
y © Hibernate 
©) Hibernate Configuration File (cfg.xrml) 
"» Hibernate Console Configuration 
" Hibernate Reverse Engineering File (reveng.xml) 
© Hibernate XML Mapping file (hbm.xml) 
> (> Java 
> > Mylyn 





" 


A 





图 11-12 Hibernate Tools 提 供 的 新 的 Eclipse 向 叶 


Hibernate Console Configuration 窗 口 打 开 以 后 〈 如 图 11-13 所 示 ) ， 
先 要 通过 点 击 相应 的 "Browse" (浏览 ) 按钮 ， 再 在 项 目 中 选 定 一 个 文 
件 ， 告 诉 工 具 到 哪儿 可 以 找到 你 的 Hibernate 配 置 文件 〈 当 第 一 次 使 用 配 
置 文件 向 导 来 创建 配置 文件 时 ， 会 自动 创建 好 配置 文件 ， 最 新 版 本 的 


Hibernate Tools 工 具 看 起 来 足够 智能 ， 可 以 目 己 在 本 书 代 码 示例 的 目录 
结构 中 找到 配置 文件 ) 。 


eoe 


Create Hibernate Console Configuration 


This wizard allows you to create a configuration for Hibernate a" 


Console, 





Classpath Mappings | 


Name; Hibernate ch 11 

Project: Hibernate ch 11 Browse... 
”wwe EGR ERROR ieee 

Type: () Core C) Annotations (dk 1.5+) (C) JPA (dk 1.5+) 





Configuration file: | /Hibernate ch 11/sre/hibernate.cfg.xml 


= 


ropeyfle [ 
Browse... 


图 11-13 建立 Hibernate Console At & 


对 于 大 部 分 项 目 来 说 ， 这 个 选项 卡 Cab) 中 的 其 他 设置 可 以 不 用 
修改 ， 不 过 ， 因 为 我 们 使 用 Maven Tasks for Ant 来 管理 我 们 的 依赖 库 ， 
而 Hibernate 不 会 奇迹 般 地 知道 到 哪 可 以 找到 Maven 仓 库 中 的 数据 库 驱 动 
程序 ， 所 以 需要 调整 类 路 径 〈Classpath) 的 设置 。 点 击 "Classpath" 选 项 
卡 ， 在 这 个 选项 卡 上 再 点 击 "Add External JARS" 按 钮 ， 手 工 告诉 工具 到 
哪 找 数据 库 驱 动 程序 ， 如 图 11-14 所 示 。 





eoo 


Create Hibernate Console Configuration F 
This wizard allows you to create a configuration for Hibernate 4 


Console. 





Oa Es || 
General 一 Classpath 一 Mappings - 


Additional classpath (Hibernate jars not necessary!) 














Add JAR/ Dir... 
( Add External JARS... N 


( Remove ) 
图 11-14 Hibernate Console 474 Ft #. 
JER: 可 以 按 共 享 模式 (shared mode) 来 使 用 HSQLDB， 提 供 多 个 


安 
数据 库 连 接 ， 不 过 这 部 分 不 在 本 书 讨论 范围 内 ， 而 且 你 还 需要 考虑 在 哪 
以 及 如 何 运行 “服务 占 "*JVM。 








在 打开 的 文件 选择 对 话 框 中 ， 导 航 到 Maven 仓 库 的 目录 (可 以 参阅 
第 1 章 1.7 节 结尾 部 分 的 介绍 ) ， 找 到 MySQL 驱 动 程序 。 在 这 个 例子 中 ， 
如 果 是 在 Mac OS XERA T, IIE MZN T 











~/.m2/repository/mysql/mysql-connector-java/5.0.5/mysql-connector-java- 
5.0.5.jar。 在 上 一 章 的 基础 上 ， 我 们 继续 使 用 MySQL。 用 Hibernate Tools 
连接 外 部 数据 库 要 方便 得 多 ， 这 时 再 像 我 们 原来 那样 ， 试 图 使 用 伦 入 在 
内 存 中 的 数据 库 ， 就 不 是 个 好 想法 了 ， 因 为 Hibernate Tools 会 认为 它们 


可 以 目 由 地 将 到 数据 库 的 连接 保持 为 打开 状态 ， 这 样 ， 当 你 想 对 数据 库 
进行 其 他 操作 ， 比 如 通过 Ant 来 运行 b 构 建 任务 来 得 看 数据 库 的 内 容 
时 ， 束 不 得 不 先 退 出 Eclipse。 相 反 ， 像 MySQL 这 样 独立 的 数据 库 ， 在 
处 理 多 个 同时 并 发 的 数据 库 连 接 时 ， 就 没有 这 样 的 问题 。 





选择 好 驱动 程序 的 JAR 文 件 以 后 ， 点 击 "Open" 按 钮 (如 图 11-15 所 


| | a, 
(<i>) EW (Q search 

= Janus fa mysqi-c...-5.0.5jar | 

@ iDisk S mysal-c....5.jar.shal 

@ Network  mysql-c...5.0.5.pom 

E Janus |S mysql-c....pom.shal 


fgg Desktop 
F jim JAR 
hy Applications . 
fy Documents ‘ 
' Jame mysql- | 
a Movies connector- | 
ġ Music java~5.0.5. | 
r jar 
©) Pictures 


@ Favorites Size 504 KB 
Kind Jar 
™ bin z FI 





图 11-15 X Hibernate Console 配 置 加 载 数 据 库 驱 动 程序 JAR 文 件 


注意 : 如 果 你 在 使 用 像 Oracle 这 样 版 权 专 有 的 数据 库 ， 可 能 就 需要 


目 己 手工 下 载 JDBC 了 驱动 程序 了 。Maven 仓 库 只 提供 自由 软件 。 


在 配置 好 类 路 径 以 后 〈 如 图 11-16 所 示 ) ， 就 可 以 点 击 "Finish" 按 
钮 ， 准 备 创 建 我 们 的 Hibernate Console 配 置 。 


Create Hibernate Console Configuration 
This wizard allows you to create a configuration for Hibernate 








图 11-16 Hibernate Console 3% 44 At E Z HE 


Hibernate Tools 会 询问 我 们 是 否 想 为 项 目 添加 对 Hibernate 的 支持 
(如 图 11-17 所 示 ) 。 好 哇 ， 那 就 是 我 们 盼望 的 啊 ! 马上 点 击 "OK" 按 


en The project named ‘Hibernate ch 11° does not have Hibernate features enabled. 
ae Should it be updated to use Hibernate ch 11? 











图 11-17 Hibernate 功能 准备 好 了 


更 多 的 编辑 文 持 


我 们 的 项 目 现在 已 经 支持 Hibernate Tools 了 ， 那 可 以 用 它 做 什么 
呢 ? 咽 ， 现 在 ， 当 你 编辑 映射 文件 时 ，XML 编 辑 器 就 能 够 帮 你 自动 完 
成 数据 表 和 列 的 名 称 〈 如 图 11-18 所 示 ) 。 这 也 正 是 为 什么 需要 将 项 目 
关联 到 Hibernate Console 配 置 的 原因 : Hibernate Tools 实 际 上 维护 着 一 个 
Hibernate 会 话 ， 通 过 它 来 检查 数据 库 模 式 ， 为 实际 项 目 环境 提供 相关 的 
帮助 。 


ML 


52> =F 
a —— 


<hibernate-mapping> > 


<class name="com.oreilly.hh.data. Track" table="track"> 
<méta attribute-"class-description"> 
Represents a single playable track in the music database. 
@author Jim Elliott (with help from Hibernate) 
</meta> 


<id name="id" type="int" column="TRACK_ID"> 
<meta attributee"scope-set">protected</meta> 
<generator class-"native"/> 

</id> 


<property name="title" typée"string”> 
<meta attribute="use-in-tostring">true</meta> 
¿column namee"" not-nulle"true" indexe"TRACK_TITLE"/> 


</property> TRACK_ID 
roperty names" 
Pa = mapai 


<property name=" PlayTime 
<meta attribut added 
</property> VOL_LEFT 
VOL_RIGHT 


‘Tree | Source | sourceMedia FI 


图 11-18 在 Hibernate 了 映射 编辑 器 中 自动 完成 列 名 的 输入 


我 们 已 经 演示 了 TRACK 表 的 列 名 的 目 动 完成 ， 不 过 也 可 以 自动 完 
成 表 名 在 class 定 义 ， 以 及 关联 定义 中 的 设置 ) 。 如 果 已 经 创建 好 了 组 
成 模型 的 Java 对 象 ， 这 时 Java 对 象 的 属性 名 和 类 名 的 输入 也 会 具有 目 动 
完成 帮助 ， 以 及 JavaDoc 文 持 〈( 如 图 11-19 所 示 )〉 。 属 性 类 型 的 自动 完成 
也 忌 是 可 用 的 ， 不 过 ， 在 非 源 代码 视图 中 通过 下 拉 有 订单 来 选择 ， 是 更 人 简 
单 的 办 法 。 























= 人 
<property nome="added" type="dote"> Di 一 一 一 一 一 
<meta ottribute=s"field-description">hern the track wos cre Y G Track.hbm.xng 















</property> Meta 
E Types 
<property name="volume" type="com.oreilly.hh.StereoVolumeType =: 


+a ere ele t 
emeto attribut a added Dave - Track How lowd to play the track 
«meta attribut 
«column nome=* 
¿column name=" 


</property> 


artists Set<com.oreilly.hh.dataArtist> = Track 
comments Set-cjavalang String> = Track 
filePath String - Track 

id int = Track 

playTime Date = Track 

sourceMedia SourceMedia - Track 

tithe String- Track 

volume StereoVolume — 


<property names" 
mêta attribut 
<meta attribut 

</property> 


56 8 8 & & 8 日 & 


<set name=" comme 
<key ¢olumn=" 
<element coly 
afset 





</class> 


图 11-19 Hibernate 映射 编辑 器 中 属性 名 称 的 自动 完成 








对 于 数据 库 驱 动 的 自动 完成 ， 我 们 确实 遇 到 了 一 个 “ 意 想 不 到 的 厅 
烦 ” Cgotcha) 。 即 便 SQL 通 常 是 不 区 分 数据 表 和 字段 名 称 的 大 小 写 ， 而 
Hibernate 需 要 区 分 。 我 们 的 曲目 数据 表 全 是 用 小 写字 母 创建 的 ， 而 映射 
文档 都 是 用 大 写字 母 引 用 的 ， 如 果 不 注 意 到 这 一 点 ， 就 不 能 正 汕 使 用 目 
动 完 成 。 修 改 映射 文 要 ， 让 它 与 数据 库 模 式 定 义 中 真实 的 大 小 写 情 况 相 
匹配 ， 就 可 以 解决 问题 了 。 














这 里 还 可 以 使 用 Eclipse 的 另 一 个 有 用 功能 ，F3 快 捷 键 ， 它 用 于 导航 
跳 转 到 变量 、 方 法 以 及 类 的 声明 位 置 ， 在 映射 编辑 器 中 使 用 这 个 快捷 键 
可 以 把 你 带 到 正在 映射 到 的 类 或 属性 的 Java 代 码 定 义 中 。 


PUNTERS ACH, See ah SCF AE MARR, 11-204 
KRA FN FEMUR EAT AN, Ari R Sj GUITARS Sat ti EA E 








serializable ~ 
short 

string 

text 

time 

timestamp 

timezone 

true_false 

yes_no 

com.oreilly.hh.SourceMediaType å 
com.oreilly.hh.StereoVolumeType k Y 





图 11-20 自 定义 类 型 映射 的 自动 完成 
稍 等 ， 还 有 更 多 


这 些 只 是 Eclipse 的 普通 功能 ， 在 Java 视 图 下 就 可 以 使 用 。 不 过 ,在 
打开 Hibernate Console 视 图 后 ， 还 有 更 多 其 他 案 门 可 以 应 用 。 要 打开 这 
个 视图 ， 可 以 点 击 工 具 条 上 的 "Open Perspective" 按 钮 ， 再 选 
择 "Other"( 其 他 ) 选项 ， 或 者 选择 Window > Open Perspective > Other. 
这 两 种 方法 都 会 打开 "Open Perspective" 对 话 框 ， 如 图 11-21 所 示 。 选 


择 "Hibernate Console"， 再 点 击 "OK" 按 钮 。 





a CVS Repository Exploring 
Debu 


RA an a pee sy 


& java (default) 

od Java Browsing 

fa Java Type Hierarchy 
D Planning 

{= Plug-in Development 
区 Resource 

50 Team Synchronizing 





图 11-21 打开 Hibernate Console 视 图 


Hibernate Console 视 图 


首先 要 注意 的 是 图 11-22 所 示 的 Hibernate Configurations (Hibernate 
配置 ) 视图 。 图 中 ， 我 们 已 经 展开 了 本 节 开 始 创建 的 "Hibernate ch 11" 配 
置 节点 ， 看 看 怎么 使 用 其 中 的 映射 、 类 、 数 据 库 模式 等 条 目 。 注 意图 中 
为 主键 〈identifier) 、 多 对 一 、 一 对 多 关联 分 配 的 标识 图 标 。 在 这 个 视 
图 中 提供 了 丰富 的 有 用 信息 。 打 开 这 个 视图 的 下 拉 菜 单 ， 可 以 看 到 通过 
它 可 以 访问 几 个 有 趣 的 功能 (同时 也 解释 了 菜单 左边 各 按钮 的 功能 
的 ) 。 
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图 11-22 Hibernate Console A F 49 Hibernate At 2 A t 


以 简单 的 方式 ， 这 一 菜单 可 以 让 我 们 编辑 现 有 的 Hibernate 配 置 、 为 
其 他 Hibernate 项 目 创建 新 的 配置 ， 如 果 在 Eclipse 环境 以 外 修改 了 某 些 文 
件 ， 还 可 以 刷新 这 一 视图 。 更 为 强大 的 是 ，"Run Schema Export" 选 项 可 
以 让 我 们 只 要 简单 地 选中 茶 个 配置 项 ， 再 运行 这 个 末 单 选项 ， 就 可 以 得 
到 与 第 2 章 编写 的 schema Ant 构 建 任务 同样 的 结果 。 


这 一 采 单 为 它 左 边 那 些 看 起 来 很 神秘 的 按钮 的 作用 提供 了 些 提示 说 
明 。 接 下 来 我 们 看 看 这 些 按钮 可 以 完成 什么 复杂 功能 ， 首 先 从 "HQL 


Editor" 开 始 ， 图 11-23 演 示 了 选择 荣 单项 并 点 击 按钮 后 ， 将 会 显示 的 界 
面 。 看 起 来 我 们 应 该 能 够 在 这 个 地 方 处 理 HQL， 但 是 使 用 Control Space 
组 合 键 试图 自动 输入 表格 名 称 时 ， 会 产生 错误 消 轧 "Configuration not 
available nor open" 〈 配 置 不 可 用 或 打 不 开 ) 。 不 过 ， 我 认为 这 里 

用 "or" 更 合适 些 ， 看 起 来 需要 将 这 个 窗口 和 茶 个 Hibernate Console 配 置 关 
联 起 来 。 行 ， 这 就 够 了 ， 虽 然 在 Mac OS X 下 界面 有 些 不 清楚 ， 不 过 顶 
部 的 菜 蛙 似乎 就 是 个 用 来 解决 问题 的 好 办 法 。 





|X| Track.hbm.xml En =L 





- | 
> i EA | Max results: | lel 
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图 11-23 一 个 室 白 的 、 未 经 配置 的 HQL Editor 视 图 





确实 如 此 ， 配 置 荣 单 就 在 这 里 。 在 选择 了 沫 单 中 的 Hibernate ch 11 
配置 项 以 后 ， 残 激活 了 编辑 器 的 独特 功能 和 自动 完成 的 功能 (如 图 11- 
24 所 示 ) 。 看 起 来 可 以 将 命名 查询 集中 在 一 起 ， 再 粘贴 到 映射 文档 中 ， 
是 吗 ? 我 们 看 看 它 还 能 做 些 什么 事情 。 








[À Track.hbm.xml fi Hi chia £3) = al 


> Hibernat... Wa r= results: | lw 
from Al 

O Album - com.oreilly.hh.data 

© artist - comoreilly.hh.data 


k 








图 11-24 在 连接 到 某 个 Hibernate Console 配 置 以 后 的 HQL Editor Rw 





在 选择 妆 单 项 后 ， 如 果 你 也 同样 得 到 关于 配置 不 可 用 的 错误 消 妃 ， 
这 可 能 意味 着 Hibernate Tools 还 没有 为 它 打 开 一 个 SessionFactory。 你 可 
以 用 鼠标 右键 点 击 Hibernate Configurations 视 图 中 的 配置 ， 再 选 
择 "Create SessionFactory" 选 项 (如 图 11-25 所 示 ) 。 其 他 一 些 操作 ， 比 如 
向 下 深入 (drilling) Configurations. Session Factory 以 及 Database 树 节点 
的 细节 ， 似 乎 也 需要 一 定 的 窍门 。 
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@ Add Configuration... 
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图 11-25 显 式 打开 配置 的 SessionFactory 





自动 完成 帮助 对 于 编写 查询 确实 有 用 《〈 它 可 以 完成 属性 名 称 、HQL 
关键 字 、 函 数 名 称 等 内 容 的 辅助 输入 ) ， 不 过 这 个 工具 真正 强大 的 功能 
还 要 数 它 可 以 让 你 运行 查询 并 查看 结果 ， 可 以 方便 地 验证 查询 和 数据 是 
否 正 确 ， 或 者 只 是 为 了 更 多 地 了 解 HQL 和 数据 模型 。 点 击 编辑 器 左边 顶 
部 的 较 大 的 那个 绿色 "Run HQL" 按 钮 ， 就 可 以 运行 HQL， 并 立即 显示 运 
行 结果 ， 如 图 11-26 所 示 。 
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|X) Track.hbm.xml | ve *Hibernate ch 11 £3 = 


i | Hibernat... re | aaa resale TA 


from Artist 











com.oreilly.hh.data_Artist 

com.oreilly.hh.data.Artise@989cac [name='PPK actualArtist="null’ | 
com.oreilly.hh.data.Artist@5615d9 [name='The Buggles' actualArtist='null' } | 
com.oreilly.hh.data.Artist@b498d1 [name='Laurie Anderson’ actualArtist='null’ ] 
com.oreilly.hh.data. Artist@9ceabe [name="William Orbit’ actualArtist='null’ ] | 
com.oreilly.hh.data.Artista@fedcf4 [name="Ferry Corsten’ actualArtist='null' ] 
com.oreilly.hh.data Artist@2436f4 [name='Samuel Barber’ actualArtist="null'] | 
com.oreillly.hh.data Artist@264374 [name="ATB' actualArtist='null’ ] 
com.oreilly.hh.data.Artist@2424eb [name='Pulp Victim’ actualArtist="null' ] | 





from Artist £3 





图 11-26 通过 Run HQL 按 钮 运行 HQL， 并 查看 结果 


来 吧 ， 演 试 一 组 。 添 加 一 些 投 影 、 排 序 以 及 聚合 函数 ， 这 真是 个 好 
机 会 ， 可 以 真正 实践 一 下 第 9 章 提 到 的 那些 查询 功能 ! 但 是 ， 在 进入 下 
一 种 编辑 器 以 前 ， 还 有 一 两 个 等 门 .…… 








如 果 你 对 大 规模 的 数据 库 表 执行 查询， 可 能 希望 对 结果 返回 的 最 多 
记录 数量 设置 一 定 的 限制 ， 这 时 惑 可 以 使 用 编辑 需 项 部 的 第 2 个 沫 单 。 
己 经 将 数据 加 载 到 了 内 存 中 ， 如 果 没 有 的 话 ，Edlipse 则 可 能 会 有 册 尝 的 
和 危险。 当然 ， 我 们 这 本 书 中 小 儿科 似 的 例子 肯定 不 会 有 任何 问题 。 











到 目前 为 止 ，Hibernate Configurations 视 图 下 面 的 Properties〈 属 
性 ) 视图 的 表现 一 般 ， 当 我 们 正在 编辑 映射 文件 时 ， 它 用 于 显示 XML 
元 素 属 性 之 类 的 东西 ， 你 以 前 在 Eclipse 中 可 能 见 过 这 些 。 点 击 Hibernate 
Query Result 〈Hibernate 查 询 结果 ) 视图 中 的 一 行 ， 再 看 看 会 发 生 什 

。 图 11-27 是 点 击 Artist 碍 询 结果 中 的 William Orbit 一 行 时 的 结 


注意 : 多 么 可 怕 的 原型 、 浏 览 、 学 习 以 及 调试 工具 ! 


你 可 以 查看 选中 结果 对 象 的 所 有 Hibernate 属 性 ， 通 过 展开 相应 的 三 
角形 图 标 可 以 深入 查看 该 对 象 的 关联 和 和 集合。 再 一 次 ， 你 应 该 自己 尝试 
一 下 这 些 功 能 。【〔 我 们 可 能 不 用 对 此 再 提 什 么 建议 了 ...... ) 








Y identifier 
id 
y Properties 
actualArtist 
name William Orbit 
Y tracks 
y #0 


added 2007-09-24 
> artists 

comments 

filePath vol2/album972/trackO2.mp3 | 

id 5 

playTime 00:07:39 

sourceMedia CD 

title Adagio for Strings (ATB Remix) 

volume Volume[left= 100, right=100) 











图 11-27 在 Properties 视 图 中 浏览 查询 结果 


你 可 能 会 问 HQL 编 辑 器 右边 的 Query Parameters (A WAO 视图 
是 做 什么 用 的 (如 果 没 这 样 的 问题 ， 也 可 能 是 因为 还 没有 显示 这 个 视 
图 ， 通 过 选择 Window -~ Show View -Other 琳 单 ， 再 从 弹出 对 话 框 的 


Hibernate 部 分 选择 Query Parameters， 就 可 以 打开 这 个 窗口 ) 。 这 个 窗口 
是 用 于 人 处理 查询 中 包含 的 命名 参数 的 。 图 11-28 显 示 了 一 个 例子 ， 我 们 
从 第 3 章 粘 贴 了 一 个 tracksNoLongerThan 命 名 查询 ， 接 着 发 现 点 击 Query 
Parameters 窗 口中 的 ":P+" 按 钮 ， 就 可 以 生成 查询 中 要 用 到 的 一 个 参数 列 
表 〈 这 个 例子 只 有 一 个 参数 ) 。 我 们 必须 将 参数 的 Type 设置 为 tme《〈 通 
过 下 拉 列 表 选 择 ) ， 按 照 窗口 列表 下 面 提 示 的 格式 帮助 信息 ， 在 Value 
列 中 输入 一 个 时 间 值 ， 再 点 击 查 询 编辑 器 顶部 左边 的 带 有 绿色 箭 》 
的 "Run" (运行 ) 按钮 ， 就 可 以 在 底部 的 Hibernate Query Result 窗 口中 看 
到 希望 的 查询 结果 了 。 
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select raskid, rackcithe from Track as ack where track playTime <= dengih order by mackie desc = 


图 11-28 在 Query Parameters 窗 口中 设置 命名 参数 


很 难 再 想像 出 一 个 比 这 更 简单 的 界面 来 试验 HQL 答 询 了 ! HQLE WY 


触发 的 核心 SQL 语句 可 以 在 下 面 这 个 窗口 中 查看 : Hibernate Dynamic 
SQL Preview 〈Hibernate 动 态 SQL 预览 ) ， 在 图 11-28 中 它 紧 挨 着 查询 结 
果 选 项 页 ， 如 果 你 在 自己 的 Eclipse 中 看 不 到 这 个 窗口 ， 可 以 通过 选择 
Window — Show View > Other 菜单 ， 再 从 弹出 对 话 框 的 Hibernate 部 分 选 
择 Hibernate Dynamic SQL Preview， 就 可 以 打开 这 个 窗口 。 在 这 个 窗口 
中 看 到 的 SQL， 就 是 我 们 在 查询 编辑 器 中 输入 的 HQL 在 执行 时 使 用 的 实 
际 的 SQL 语 句 ， 如 图 11-29 所 示 。 








©) Error Log | F Hibernate Query Result | 本 Hibernate Dynamic SQL Preview 3 \ Console) ~ O 


select 
wackO_.TRACK_ID as col_O_O_, 
wackO_.TITLE as col_1_0_ 
from 
track trackO_ 
where 
trackO_.playTime< =? 
order by 
trackO_.TITLE desc 
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图 11-29 Dynamic SQL Preview’ 7 





这 个 窗口 的 内 容 非 常 有 趣 ， 因 为 它 是 真正 动态 的 ， 正 如 其 窗口 标题 
所 示 。 如 采 在 HQL 编 辑 圳 中 编辑 查询 的 同时 ， 保 持 打开 这 个 窗口 ， 就 可 
以 看 到 你 正在 输入 的 HQL 语 句 所 对 应 的 SQL 语句 ， 这 样 的 效果 相当 直 
观 。 例 如 ， 考 虑 如 图 11-30 所 示 的 非常 简单 而 且 自 然 的 HQL 查 询 ， 以 及 
该 HQL 生 成 的 SQL 语句 。 


E Trackhbmxml 


j> | | Hibernat... Fy ‘Max results: 


from Artist 
where tracks.size > 1| i 











|F] Error Log | “ Hibernate Query Result 


0: com si hh data Artist 


select 
artist0_ARTIST_ID as ARTIST1_7_ 
artist0_.NAME as NAME? 


artistO_.actualArtist as actualAr3_7. 
from 


ARTIST artistO_ 
where 
{ 
| select 
countitracks1.-ARTIST_ ID) 
from 
TRACK ARTISTS tracks 1_ 
re 


*) Hibernate Dynamic SQL Preview 23 


artist. ARTIST_ID=tracks 1. ARTISTID 
j>1 





图 11-30 同时 查看 简洁 的 HQL 与 完整 的 SQL 


就 像 我 们 的 一 位 技术 编辑 指出 的 ， 这 是 在 对 SQL 不 十 分 了 解 的 Java 
开发 人 员 和 对 HQL 或 JDBC 不 感 兴趣 的 DBA 之 间 进 行 交 流 的 非常 有 价值 
的 工具 。 





最 后 ，Criteria Editor 〈 条 件 得 询 编辑 器 ) 窗口 ， 可 以 通过 最 后 一 个 
还 没有 介绍 过 的 按钮 访问 ， 如 图 11-31 所 示 ， 它 的 作用 应 该 可 以 通过 其 
名 称 猜 得 出 来 。 它 可 以 让 你 生成 Criteria 查 询 的 原型 ， 提 供 Java 代 码 的 自 
动 完成 《以 及 预定 义 的 会 


话 变 量 ， 以 作为 供 查 询 使 用 的 Hibernate 
Console 配 置 的 会 话 ) 。 





E Track.hbm.xmi (_ T z = SF :pa z 


> | iNe HQL + 
| Hibernat... ry Max results: Ta 


Criteria criteria = session.createCriteria(Track.class); | 
criteria.add(Restrictions.Ifke("title", "w", MatchMode, ANYWHERE) 


-ignoreCase()); "i le(String propertyName, Object value) SimpleExpres 
e leProperty(String propertyName, String otherProper 
人 like(String propertyName, Object value) Si 
e like(String propertyName, String value, MarchMode 
m itiString propertyName, Object value) SimpleExpres 
G hProperty(String propertyName, String other Prope 


























F> Hibernate Query Rest 





| eno info> 
com.oreilly.hh.data.Track@e690cf [title=" Video Killed the Radio Star’ volume='Volumefleft= 100, right= 1 
com.oreilly.hh.data.Track@2d27d6 [tithe="Gravity's Angel volume="Volume[left= 100, right= 100)" sourt 





图 11-31 Hibernate Tools% Criteria Editor 


如 宁 你 发 现 目 动 完 成 功能 不 能 使 用 ， 记 得 检查 Run 按 钮 劳 边 的 沫 单 
中 是 否 选择 了 有 效 的 Hibernate Console 配 置 ， 就 像 HQL Editor 的 使 用 一 
样 。 同 时 ， 也 要 确保 Eclipse 认为 Criteria Editor 窗 口 处 于 选中 状态 (其 边 
框 为 蓝 色 ) 。 有 时 我 正 准备 要 在 Criteria Editor 窗 口中 输入 些 东西 时 ， 而 
查询 结果 窗口 的 边框 却 是 歼 色 的 ， 所 以 本 来 可 以 自动 完成 或 编辑 的 键盘 
命令 都 无 法 正常 使 用 。 


其 他 


代码 生成 功能 ?这 些 也 可 以 用 ， 只 是 我 们 在 前 面 还 没有 直接 关注 它 
们 。 在 为 特定 的 项 目 添加 工具 支持 以 前 ， 它 们 就 已 经 可 以 使 用 ， 不 过 在 
我 们 至 少 创 建 一 个 Hibernate Console 配 置 以 前 ， 它 们 并 不 会 做 些 什 么 。 
再 仔细 看 看 Eclipse 工 具 条 ， 就 会 发 现 Hibernate Tools 还 提供 了 一 个 新 的 
菜单 选项 (如 图 11-32 所 示 )。 
| cris ] He Oy Qe | Qala Ge | | te Se ce | 
i Run As > 


Q, Open Hibernate Code Generation Dialog... 
Organize Favorites... 


一 
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<hibernate-mapping> 


图 11-32 Hibernate Tools 提 供 的 代码 生成 菜单 





这 个 新 荣 单 隐藏 得 很 隐蔽 ， 需 要 费 些 时 间 才 能 看 到 它 。 这 个 某 单 是 
访问 Hibernate Tools 用 来 建立 和 运行 代码 生成 功能 的 图 形 界 面 的 门户 。 





代码 生成 


让 我 们 看 看 如 何 用 Hibernate Tools 实 现 原 来 在 第 2 章 中 创建 的 
codegen Ant 构 建 目 标 完成 的 功能 。 为 了 避免 翻 书 查找 例子 的 贱 烦 ， 重 新 
在 例 11-1 中 列 出 该 构建 目标 的 内 容 。 


例 11-1: 重 温 代码 生成 的 Ant 构 建 任务 














<! --Generate the java code for all mapping files in our source 
tree--> 

<target name="codegen"depends="usertypes" 

description="Generate Java source from the O/R mapping files"> 

<hibernatetool destdir="${source.root}"> 

<configuration 
configurationfile="S{source.root}/hibernate.cfg.xml"/> 

<hbm2java jdk5="true"/> 

</hibernatetool> 

</target> 









































为 了 在 Eclipse 中 重新 实现 这 一 功能 ， 我 们 先 从 图 11-32 所 示 的 沫 单 
中 选择 Open Hibernate Code Generation 对 话 框 。 窗 口 界面 如 图 11-33 所 
示 ， 像 其 他 Eclipse 工 具 一 样 ， 这 个 对 话 框 也 提供 了 让 你 选择 命名 配置 的 
Ties 





Hibernate Code Generation... 


Configure launch settings from this dialog: 
type filter text T = Press the 'New button to create a configuration of the selected type. 


Q Hibernate Code Generation IF] = Press the ‘Duplicate’ button to copy the selected configuration. 
R 3 = Press the ‘Delete’ button to remove the selected configuration. 
$o = Press the ‘Filter’ button to configure filtering options. 


= Edit or view an existing configuration by selecting it. 


Configure launch perspective settings from the Perspectives preference page. 


f | Filter matched 1 of 1 items 


图 11-33 准备 创建 一 个 新 的 Hibernate 代 码 生 成 配置 


看 起 来 为 了 激活 创建 新 配置 的 功能 ， 在 点 击 "New" 按 钮 以 前 需要 先 
点 击 "Hibernate Code Generation" 选 项 卡 。 


在 激活 创建 新 配置 的 功能 后 ， 就 可 以 点 击 "New" 按 钮 (这 个 按钮 的 
图 标 是 一 个 页 面 标志 ， 在 页 面 的 右上 角 有 个 加 号 ) 来 建立 一 个 配置 ， 以 
生成 我 们 的 数据 对 象 。 它 会 打开 一 个 配置 窗口 ， 上 面 有 很 多 选项 ， 其 中 
的 一 些 选项 如 图 11-34 所 示 。 


eop Hibernate Code Generation... 


Create, manage, and run configurations 
Console configuration must be specified 














[me ES : 
Name: New configuration 





| type filter text 








¥ 人 Hibernate Code Generation 


Qy New configuration | consola configuration: | = 
k 


| 
| | Output din rector 


图 11-34 创建 一 个 Hibernate 代 码 生 成 配置 


注意 : 当然 ， 如 果 你 在 Eclipse 工作 空间 中 打开 多 个 项 目 ， 在 这 个 浏 
览 对 话 框 中 就 可 以 看 到 更 多 的 选择 根 节 点 。 


我 们 将 新 的 配置 命名 为 "Generate Ch 11 Model"， 选 择 Hibernate 
Console 配 置 ， 浏 览 打 开 项 目的 src 目 录 〈 如 图 11-35 所 示 ) ， 最 终 对 话 框 
的 Main 选 项 页 界面 应 该 如 图 11-36 所 示 。 


=> Hibernate ch 11 
> & settings 
> & .svn 


> = classes 


DR 





图 11-35 指定 生成 的 代码 的 输出 目录 


Name: Generate Ch 11 Model 


Console configuration: 


Output directory: [Hibernate ch 11/src | ( Browse... 


[ | Reverse engineer from JDBC Connection 


Package: 
reveng.xm!: 
reveng. strategy: 


v Generate basic typed composite ids 
v Detect optimistic lock columns 


Vv Detect many-to-many tables 





日 Use custom templates (for custom file generation) 








图 11-36 在 Main 选 项 页 中 设置 代码 生成 的 配置 ， 以 实现 用 codegen Ant 
构建 目标 完成 的 功能 


我 们 只 需要 关注 Name， 以 及 Main 选 项 卡 上 的 头 两 个 选项 ， 因 为 我 
们 并 不 打算 对 现 有 数据 做 些 奇特 的 反 回 工程 处 理 〈 哪 天 需要 将 遗留 下 来 
的 大 型 数据 库 模 式 转 换 到 Java 模 型 时 ， 你 可 以 自己 再 研究 一 下 这 个 强大 


功能 ) 。 接 着 ， 我 们 再 转移 到 Exporters (GH) 选项 卡 。 点 击 这 个 选项 
卡 ， 将 打开 如 图 11-37 所 示 的 程序 界面 ， 填 写 些 信息 ， 以 再 现 原 来 的 Ant 





构建 目标 的 行为 。 


General settings: 
vw Use Java 5 syntax 
门 ] Generate £JB3 annotations 


J Domain code (java) 
E B Hibernate XML Mappings (.hbm.xml) 
© DAO code (java) 


© Hibernate XML Configuration (.cfg.xml) 
ae Schema Documentation (html) 











A 11-37 Exporters 配 置 ， 以 再 现 原 来 的 codegen Ant 构 建 目标 


我 们 选中 了 Use Java 5 syntax 复 选 框 ， 就 相当 于 在 Ant 构 建 任务 中 设 
置 了 jdk5=true 属 性 ， 同 时 也 选中 Domain code (java) 导出 选项 。 注 意 ， 
虽然 我 们 用 的 不 多 ， 还 是 有 很 多 其 他 导出 生成 器 可 供 我 们 用 于 创建 映射 





文件 、 全 局 的 Hibernate 配 置 文件 甚至 是 数据 库 模 式 的 某 种 web 文档 。 此 
外 ， 也 可 以 创建 某 种 数据 访问 对 象 DAO 代码 ) ， 以 标准 化 、 方 便 的 方 
式 来 简化 对 模型 对 象 的 加 载 和 处 理 。 虽 然 与 这 些 选 项 相关 的 主题 已 经 超 
出 本 书 的 讨论 范围 ， 不 过 你 可 以 自己 研究 它们 的 使 用 方法 ， 至 少 应 该 先 
记 下 来 ， 以 备 不 时 之 需 。 





注意 : 提供 GUI 的 目的 是 为 了 解决 什么 ..………. 至 少 它们 涵盖 了 常见 的 
应 用 案例 。 


可 能 你 会 问 选 项 卡 底部 的 Properties 部 分 是 做 什么 用 的 。 它 基本 上 用 
于 让 你 设置 那些 不 能 用 图 形 界面 表示 的 每 个 Exporters CHRR) 参数 。 
点 击 任何 一 个 Exporters《〈 列 表 中 的 名 字 ， 而 不 是 复 选 框 ) ， 就 会 显示 手 
工 为 那个 生成 句 设 置 的 所 有 属性 ， 同 时 也 激活 "Add" 和 "Remove" 按钮 ， 
以 便 可 以 编辑 各 个 属性 。 对 于 有 什么 属性 ， 以 及 它们 的 作用 ， 可 以 参考 
生成 器 的 文档 。 














对 于 我 们 当前 的 任务 ， 就 是 要 重新 实现 以 前 用 build.xml 文 件 实现 的 
功能 ， 这 个 文件 内 部 的 那些 配置 就 是 正确 的 设置 。 事 实 上 ， 这 些 也 正 是 
我 们 真正 需要 设置 的 。 不 过 ， 在 这 里 看 一 些 Eclipse 特定 的 选项 ， 也 是 有 
WME. Refresh Chiller) 选项 卡 〈 如 图 11-38 所 示 ) 可 以 让 你 控制 在 运 
行 Experters 以 后 ，Eclipse 应 该 自动 刷新 哪些 资源 。 





图 中 我 们 选择 刷新 生成 代码 所 属于 的 那个 项 目 。 似 乎 这 样 符合 我 们 


正在 进行 的 操作 。 





| v Refresh resources upon completion. 


O The entire workspace 


C) The selected resource 


@ 


The project containing the selected resource 
CS folder containing the selected resource 


() Specific resources ( Specify Resources...) 


iv Recursively include sub-folders 





图 11-38 代码 生成 后 的 刷新 选项 


最 后 ，Common OMH) 选项 卡 上 的 默认 设置 看 起 来 就 不 错 了 ， 不 
需要 修改 ， 点 击 "Apply" OYA) 按钮 。 


我 们 刚才 的 配置 将 出 现在 左边 的 列表 中 如 图 11-39 所 示 〉。 这 时 
我 们 可 以 先 选中 它 ， 再 点 击 "Run" 按 钮 (如 图 11-34 的 压 部 右边 所 示 〉。 
或 者 ， 如 果 我 们 认为 可 能 需要 经 常 运行 它 的 话 ， 可 以 将 它 设 置 为 工具 条 
沫 单 上 的 一 个 快捷 按钮 ， 这 样 它 就 可 以 出 现在 菜单 的 项 部 了 。 从 现在 
起 ， 我 们 只 要 从 这 个 对 话 框 中 选择 相应 的 配置 ， 再 点 击 "Run" 按 钮 ， 就 


可 以 测试 运行 


Ta 


type filter text 


y Q Hibernate Code Generation 
Q, Generate Ch 11 en‘ 


图 


11-39 ”我 们 的 代码 生成 配置 现在 可 以 运行 了 


运行 它 并 不 会 产生 什么 特别 的 结果 ， 只 是 Eclipse 窗口 底部 右边 的 状 
态 栏 会 简单 地 显示 正在 进行 的 后 台 活 动 〈 我 们 保持 Common 选 项 卡 中 的 


Launch in background 配 置 选 项 为 选中 状态 ， 
要 看 看 它 是 否 做 了 些 什么 ， 





这 正 是 我 们 想 要 的 结果 ) 。 


可 以 找到 生成 的 类 《例如 Album.java) 来 看 


看 。 例 11-2 中 的 代码 演示 了 由 Hibernate Tools 生 成 的 Album 类 源 代 码 的 开 


TA 


例 11-2: Eclipse 中 的 Hibernate Tools 生 成 的 Album 类 的 源 代码 





package com. 
//Generated 
import 
import 
import 
import 
import 





java 


oreilly.hh.da 
Jan 5, 2008 6: 


sU 
java. 
java. 
java.ut 
java.ut 


u 
ut 
ut 
u 


til 








T 
TL 
il 
工 


-ArrayList; 
til.Date; 





ta; 
36: 04 PM by Hibernate Tools 3.2.0.CR1 





/** 

*Represents an album in the music database, an organized list of 
tracks. 

*@author Jim Elliott (with help from Hibernate) 

大 



































*7 

public class Album implements java.io.Serializable{ 
private int id; 

private String title; 

private Integer numDiscs; 

private Set<Artist>artists=new HashSet<Artist> (0) ; 




















源 文 件 中 的 时 间 惟 和 工具 版 本 号 都 表明 这 个 类 是 最 新 生成 的 〈 想 到 
我 们 正在 使 用 的 Maven for the Ant tasks 中 提供 的 3.2.0.b9 版 本 ， 谁 知道 最 
新 版 本 进入 Maven 仓 库 的 延迟 会 有 好 的 一 方面 呢 ? ) 。 另 一 方面 ， 这 一 
结果 看 起 来 与 Ant 生 成 的 结果 类 似 。 并 不 太 令 人 振奋 ， 或 许 我 们 已 经 预 
见 到 了 这 些 。 





那 还 剩 下 什么 要 我 们 去 做 ? 像 这 样 内 建 到 Eclipse 中 的 工具 可 以 极 大 
地 市 省 项 目的 设计 和 开发 周期 。 能 够 将 伍 询 和 数据 库 模 式 辅助 目 动 完 
成 、 属 性 浏览 以 及 实时 SQL 显示 等 集成 在 一 起 ， 这 本 喘 就 是 一 种 理解 数 
据 和 模型 对 象 的 很 好 方法 。 本 书 前 面 为 测试 各 种 查询 而 需要 编写 单独 的 
代码 示例 ， 再 编译 、 运 行 、 调 整 它 们 ， 与 这 种 繁 天 的 方法 相 比 ， 图 形 化 
工具 无 疑 更 加 快速 、 更 加 方便 。 你 可 以 快速 地 测试 许多 查询 的 变化 ， 而 
且 不 需要 索 琐 的 模板 代码 《无论 如 何 ， 使 用 Hibernate 后 ， 这 样 的 代码 已 
经 没有 多 少 了 ) 来 建立 运行 环境 。 











映射 图 表 


在 本 书 大 部 分 的 写作 时 间 内 ，Hibernate Tools 一 直 都 是 Beta 版 本 ， 
还 不 支持 本 节 最 后 介绍 的 这 个 功能 。 幸 好 ， 就 在 本 书 交 付 印刷 前 夕 ， 发 
布 了 3.2 的 最 终 版 本 ， 这 一 版 本 文 持 映射 图 表 。 对 象 和 数据 模型 之 间 的 
图 形 视图 对 理解 它们 之 间 的 关系 很 有 帮助 ， 现 在 Eclipse 中 就 可 以 生成 这 
样 的 图 表 了 。 为 了 创建 图 表 ， 先 在 Hibernate Configurations 视 图 中 选择 一 
个 映射 类 ， 打 开 它 的 上 下 文 关联 菜单 (用 鼠标 右键 点 击 元 素 或 在 按 住 
Control 键 的 同时 点 击 元 素 ， 如 图 11-40 所 示 ) ， 再 选择 Open Mapping 














Diagram. 


这 会 生成 一 个 类 似 图 11-41 的 新 视图 。 为 了 让 视图 适合 页 面 的 大 
小 ， 这 里 选择 了 一 个 简单 的 类 ， 但 如 果 使 用 大 屏 硕 ， 你 可 以 深 动 视图 ， 
PLAC AMT RZ lA) RIN KIARA, FER HA. WRU EMA 
表 中 各 元 素 的 位 置 ， 可 以 随意 拖 动 它 们 到 任何 地 方 ; 还 可 以 使 用 图 表 中 
的 上 下 文 关联 沫 单 来 打开 你 感 兴 趣 的 源 文件 和 映射 文档 。 






















<?xml versione"1.@"?> 
<!IDOCTYPE hibernate-mapping PUBL? 
"http: //hibernate.sour 










v [Ñ Hibernate ch 11 
v [Ñ Configuration 
<hibernate-mapping= 











$s name="com.oreilly.hh.do® 
ta attribute-"class-descr’ 
lepresents an artist who i: 
author Jim Elliott (with | 
ta> 


if HQL Editor 
ta Hibernate Criteria Editor 


田 Add Configuration... 
& Rebuild configuration 
Edit Configuration 
Delete Configuration 


Refresh 
Run SchemaExport 





name="id" type="int" colur 
ta attribute="scope-set"> 
enerator class="native"/> 
> 












© Hibernate Query Result $3 





Open Mapping Diagram . 


图 11-40 打开 一 个 映射 对 象 的 模型 图 表 


| [DD Track java 


© com-oreilly.hh.data Artist -> ARTIST ai , | 
E id: int | =E ARTIST 从 
E name : string + = Îi ARTIST_ID 
{+} tracks ; Set<com.oreilly.hh.data.Track> » dj) NAME 

E. key » Pf actualArtist 

+ element 
®-LactualArtist : com.oreilly.hh.data Artist 


ER TRACK_ARTISTS 
PA TRACKID 
全 ARmsT_ID 





图 11-41 类 的 映射 图 表 


明显 地 ， 可 感知 数据 库 模式 Cschema-aware) 的 XML 和 查询 编辑 ， 
用 于 构建 映射 和 Hibernate 配 置 的 GUI 选 项 ， 这 些 相 当 有 用 的 功能 是 将 
Eclipse 作 为 开发 首选 的 工具 而 获得 的 好 处 。 用 图 表 来 帮助 实现 数据 的 可 
视 化 和 理解 ， 真 是 为 Eclipse 锦 上 添 花 。 而 且 ， 能 够 与 Hibernate 会 话 动态 
地 进行 交互 ， 点 击 一 下 按钮 就 可 以 生成 代码 ， 在 IDE 中 就 可 以 运行 查 
询 ， 甚 至 不 用 建立 Ant 构 建文 件 就 可 以 完成 很 多 用 其 他 办 法 无 法 实现 的 
功能 。 如 果 你 正在 考虑 这 些 文字 介绍 ， 对 如 何 才能 不 需要 很 麻烦 地 手工 
将 Maven 资 源 添 加 到 类 路 径 中 而 感 兴趣 ， 下 一 章 将 会 为 你 独辟蹊径 。 











第 12 音 ”Maven 进 阶 











如 有 果 从 OReily 的 网 站 下 载 我 们 的 示例 代码 ， 你 会 发 现 每 一 章 的 示 
例 目录 都 包含 一 个 神秘 的 pom.xml 文 件 ， 我 们 还 没有 介绍 过 这 个 文件 。 
pom.xml 是 Apache Maven 这 个 构建 工具 的 配置 文件 ， 现 在 这 个 工具 已 经 
广泛 用 于 取代 Apache Ant。 对 Maven 完 整 的 介绍 不 在 本 书 讨论 的 范围 以 
内 ， 不 过 ， 我 们 党 得 这 里 介绍 些 有 关 如 何 随 Hibernate 一 起 安装 和 使 用 
Maven， 这 些 应 该 够 用 了 。 本 章 旧 在 为 Maven 提 供 最 简洁 的 介绍 ， 重 点 


说 明 Maven 和 Hibernate3 插 件 的 使 用 ， 顺 便 也 会 介绍 一 些 Maven 的 核心 概 


全 
JU o 


什么 是 Maven 





Maven 是 一 种 声明 式 (declarative) 的 构建 工具 ， 它 不 是 定义 一 套用 
于 构建 项 目的 过 程 步骤 ， 而 是 用 保存 在 pom.xml 文 件 中 的 Project Object 
Model (POM， 项 目 对 象 模型 ) 来 描述 项 目 。 担 当 重 任 的 Maven 插 件 ， 
它们 知道 如 何 读 取 POM 文 件 和 完成 任务 。 例 如 ， 默 认 的 Maven 插 件 可 以 
编译 代码 、 创 建 JAR 文 件 、 组 装 WAR 文 件 、 创 建 Web 网 站 、 为 JAR 文 件 
生成 数字 签名 Csign) 、 计 算 代码 质量 度量 〈code metrics) 、 执 行 单元 
测试 、 读 取 Hibernate 映 射 文件 等 。 使 用 Maven， 你 所 有 需要 做 的 就 是 告 
诉 它 源 代码 在 哪里 ， 需 要 依赖 什么 文件 ，Maven 足 够 聪明 ， 它 会 明白 接 


下 来 应 该 做 什么 。 如 果 不 用 Maven， 而 是 使 用 像 Apache Ant 这 样 的 工 
有 具 ， 就 得 定义 一 个 显 式 的 构建 过 程 。 如 前 所 述 ，Maven 采 用 声明 式 的 方 
法 来 构建 和 测试 一 个 项 目 ， 作 为 Ant 的 替代 品 ， 它 很 快 就 受到 了 欢迎 。 











TER: Maven 可 以 为 你 节约 很 多 时 间 ， 但 是 你 要 去 学 习 和 习惯 它 。 


获得 方便 的 同时 也 需要 付出 一 定 的 代价 。Maven 之 所 以 知道 如 何 处 
理 你 的 项 目的 源 代 码 、 配 置 以 及 单元 测试 ， 是 因为 它 做 了 一 些 假设 。 首 
先 ，Maven 假 设 你 的 项 目 采 用 的 是 标准 布局 和 构建 生命 周期 。 所 以 ， 在 
使 用 Maven 之 前 ， 我 们 希望 你 确实 知道 了 Maven 的 这 些 核心 假设 。 一 个 
假设 就 是 对 项 目的 定义 。 在 Maven 中 ， 一 个 project 是 由 源 代码 和 资源 组 
成 的 ， 每 个 资源 与 一 个 artifact 对 应 。 这 个 artifact 可 以 是 类 似 JAR 或 WAR 
之 类 的 文件 ， 不 过 ， 需 要 知道 的 一 个 重点 就 是 一 个 项 目 只 有 一 个 
artifact。 男 一 个 假设 是 (大 多 数 情况 下 〉 你 应 该 使 用 标准 的 目录 布局 。 
在 pom.xml 文 件 中 可 以 对 Maven 的 大 部 分 默认 设置 进行 修改 。 如 果 你 不 
想 将 源 代码 保存 在 src/main/java 目 录 中 ， 则 可 以 在 pom.xml 中 指定 男 一 个 
目录 。 





注意 : 如 果 你 不 喜欢 Maven 的 约定 ， 可 以 考虑 换个 工具 。 


如 果 你 喜欢 Maven， 但 手边 的 几 个 项 目 确实 不 能 完全 满足 Maven 假 
设 的 要 求 ， 也 不 必 放 弃 Ant。 事 实 上 ，Maven 在 现 有 的 Ant 构 建文 件 中 对 
它 进行 调用 也 提供 了 方便 的 机 制 。 除 了 本 章 少数 几 个 示例 以 外 ， 本 书 的 





大 部 分 示例 就 以 Ant 构 建文 件 作 为 基础 。 如 果 你 下 载 随 书 的 示例 代码 ， 
就 会 发 现 本 章 特 殊 的 示例 具有 与 其 他 章节 不 同 的 目录 布局 。 我 们 研究 一 
下 这 种 目录 结构 ， 也 就 是 Maven 中 所 谓 的 标准 目录 布局 (Standard 


Directory Layout) 。 











有 关 Maven 更 详细 的 介绍 ， 可 以 阅读 Sonatype 的 《Maven: The 


Definitive Guide) (|H) 。 








Maven 的 标准 目录 布局 


理想 的 构建 工具 应 该 能 够 自动 知道 如 何 处 理 一 套 Java 源 文件 。 这 样 
的 系统 将 会 具有 一 定 的 内 建 智能 ， 可 以 让 你 简单 地 编写 一 定 的 源 代码 ， 
再 将 简单 的 文件 放 在 项 目 根 〈root) 目录 下 ， 运 行 构建 工具 ， 再 回 到 项 
目 目录 。 构 建 工具 会 认为 你 的 项 目 包含 一 定 的 Java 源 代码 ， 你 想 根据 它 
们 而 生成 一 个 JAR 文 件 。 如 果 你 想 生 成 的 是 WAR 文 件 ， 就 应 该 提供 一 些 
提示 ， 以 修改 构建 工具 的 默认 行为 。 





这 种 思想 已 经 由 Maven 实 现 了 ， 至 少 实现 了 一 部 分 ， 因 为 Maven 提 
供 了 一 套 严格 的 约定 ， 消 除了 大 部 分 常见 配置 的 需要 。 这 就 是 所 谓 
的 “约定 优 于 配置 ”(convention over configuration) ， 在 过 去 几 年 中 这 种 
思想 在 Ruby on Rails 之 类 的 框架 中 变 得 非常 流行 ， 它 让 你 即便 是 编写 非 
第 复杂 的 Web 应 用 程序 也 不 必 为 不 计 其 数 的 配置 文件 而 费心 (第 14 章 介 


绍 的 Stripes 也 采用 了 Java 业 界 的 类 似 方法 ) 。 约 定 优 于 配置 ， 这 也 是 为 
什么 Apple 笔 记 本 电脑 总 是 可 以 开 箱 即 用 (out of the box) 的 原因 ， 也 是 
为 什么 在 驾驶 汽车 前 你 不 用 阅读 它 的 使 用 手册 就 知道 油门 在 右边 而 刹车 
在 左边 的 原因 。 通 过 同样 的 策略 (如 果 你 已 经 遵守 了 约定 ) ，Maven 就 
会 自动 知道 你 的 源 代码 、 单 元 测试 、 网 站 文档 以 及 配置 文件 都 在 什么 地 
方 ， 而 不 用 浪费 你 宝贵 的 时 间 亲 自 告 诉 Maven 这 些 东 西 都 放 在 哪儿 。 例 
12-1 显 示 了 Maven 的 项 目 目录 布局 的 大 致 样子 。 








例 12-1: Maven 的 标准 目录 布局 
pom. Xml 


每 个 项 目 都 必须 有 一 个 pom.xml 文 件 〈 即 一 个 POM) 。 本 章 后 面 的 


第 12.6 节 将 详细 介绍 POM 文 件 。 
SITC/ 
在 这 个 子 目 录 中 保存 各 种 源 文件 。 
src/main/java/ 


将 要 包含 在 最 终 artifact (JAR 文 件 、WAR 文 件 等 ) 中 的 Java 源 代码 
位 于 这 个 目录 。 


src/main/resources/ 


这 个 目录 包含 项 目 需要 的 各 种 资源 : 非 Java 源 代码 、 类 似 
log4j.properties 的 东西 、hibernate.cfg.xml、 本 地 化 〈localization ) 文件 以 
及 需要 发 布 的 Hibernate 映 射 文件 。 


src/test/java/ 

保存 Unit 测 试 代 码 〈TestNG 或 JUnit 测 试 ) 。 
src/test/resources/ 

保存 只 供 测试 使 用 的 资源 。 

src/site/ 

网 站 文档 保存 目录 。 


target/ 





构建 过 程 生 成 的 任何 东西 ， 可 以 是 源 代码 、 字 节 码 或 最 终 的 产品 ， 
都 将 保存 在 target 目 录 中 。 因 为 target 中 的 文件 是 构建 过 程 的 产物 ， 所 以 
可 以 随意 删除 ， 不 应 该 包括 在 版 本 控制 (version control) +. 





还 有 一 些 其 他 目录 ， 比 如 src/main/webapp、src/main/config、 
src/main/assembly 以 及 src/main/filters， 这 里 不 对 它们 进行 过 多 的 介绍 ， 
在 充分 利用 Maven 创 建 复杂 的 应 用 程序 时 ， 这 些 目 录 都 有 各 自 不 同 的 用 
途 。 例 如 ， 如 果 我 们 要 生成 一 个 WAR 文 件 ， 则 src/main/webapp 将 是 Web 











应 用 程序 的 文档 根 目 录 。 如 果 我 们 为 命令 行 应 用 程序 创建 一 个 自 定义 的 
文档 包 ， 则 src/main/assembly 目 前 用 于 保存 我 们 将 要 使 用 的 装配 描述 符 
(assembly descriptor) 。 例 12-1 中 列举 的 那些 目录 将 出 现在 每 个 Maven 
项 目 中 ， 它 们 是 Maven 项 目 最 低 的 公共 约定 标准 。 








虽然 这 些 看 起 来 似乎 是 相对 简单 的 想法 ， 但 业界 目前 还 没有 对 Java 
项 目的 标准 目录 布局 之 类 的 事 达 成 一 致 。 事 实 上 ， 反 对 使 用 Maven 最 常 
见 的 一 个 理由 就 是 人 们 不 喜欢 Maven 约 定 的 目录 结构 。 其 实 你 可 以 容易 
地 自 定义 这 种 目录 结构 ， 如 果 你 看 看 本 书 其 他 章节 的 示例 代码 ， 就 会 发 
现 我 们 采用 的 也 是 自己 的 目录 布局 结构 。 这 种 方法 也 有 一 些 缺 点 ， 例 
如 ， 由 于 使 用 自 定义 目录 布局 而 引起 的 微妙 问题 ， 有 几 章 示例 就 与 
Maven Hibernate3 插 件 并 不 完全 兼容 。 所 以 我 向 你 再 次 警告 ， 尽 可 能 不 
要 试图 让 Maven 适 应 你 的 项 目的 自 定义 目录 布局 ， 而 是 在 自 定义 之 前 调 
整 你 的 项 目 以 适应 Maven 的 标准 目录 布局 。 不 过 有 些 简单 的 区 别 也 不 会 
给 Maven 造 成 任何 问题 ， 比 如 将 资源 保存 到 src/main/java 目 录 下 ， 或 者 配 
置 Maven， 让 它 把 源 代码 保存 到 src/java 目 录 而 不 是 src/main/java 目 录 
下 。 就 像 Maven 对 源 代码 有 一 定 的 标准 一 样 ， 它 对 工具 生成 的 源 代码 也 
有 一 定 的 约定 (这 些 代 码 文 件 最 终 位 于 target/generated-source 目 录 下 ， 
它们 包含 在 "compile source roots" 列 表 中 ， 所 以 它们 将 与 你 自己 编写 的 代 
码 一 起 进行 编译 ) 。 









































注意 : 本 章 的 主题 或 者 是 “接受 Maven 的 约定 ”， 或 者 是 “你 将 被 同 


化 。 抵 抗 是 没 用 的 ”。 











如 果 当 你 读 完 本 节 后 会 想 “ 嗯 ， 我 们 有 更 好 的 目录 布局 ”， 非 常 不 
幸 ，Maven 不 适合 你 了 。 如 果 你 想 试 图 调整 一 些 Maven 的 核心 假设 ， 可 
能 要 人 花费 好 些 天 来 对 付 一 系列 莫名 其 妙 的 问题 。 最 后 ，Maven 跑 不 起 来 
了 ， 你 将 开始 大 声 地 诅 史 Maven， 接 独 在 博客 上 发 帖子 说 你 有 多 么 多 人 么 
地 讨厌 它 ， 这 一 切 都 因为 你 不 愿意 接受 Maven 基 本 的 假设 。 可 能 你 还 
有 注意 到 ， 本 章 开 始 的 几 节 都 在 尽 可 能 地 为 你 节省 时 间 。 我 可 以 证 明 
Maven 为 了 节省 了 无 数 的 时 间 和 精力 ， 从 效率 的 角度 来 说 ， 给 了 我 意外 
的 收获 。 但 是 我 也 看 到 有 些 人 使 用 Maven 的 方向 就 是 错误 的 ， 最 终 除了 
对 Maven 的 不 满 以 外 ， 项 目 上 一 无 所 获 。 适 应 Maven， 而 不 是 让 Maven 
适应 你 。 这 些 已 经 接近 事实 ， 但 如 果 你 一 开始 就 质疑 这 些 事实 的 话 ， 
伤 的 就 只 能 是 你 目 己 。 








[1] http://www.sonatype.com/book/index.html. 


安装 Maven 


Maven 的 二 进 制 发 行 版 本 可 以 从 
http://maven.apache.org/download.html 下 载 ， 下 载 适合 你 使 用 的 格式 的 当 
前 最 新 版 本 ， 为 它 选 择 一 个 合适 的 保存 位 置 ， 并 在 那里 解 开 压缩 包 。 如 
果 你 将 文档 解压 到 类 似 /usr/local/maven-2.0.8 这 样 的 目录 中 ， 则 可 能 还 应 
该 创建 一 个 到 这 个 目录 的 符号 链接 以 方便 使 用 ， 这 样 ， 在 更 新 到 新 版 本 
时 也 不 必修 改 环境 配置 : 





/usr/local%ln-s maven-2.0.8 maven 
/usr/local%export M2 HOME=/usr/local/maven 
/usr/local%export PATH=${PATH}: ${M2 HOME}/bin 



































在 安装 好 Maven 后 ， 还 需要 做 两 件 事情 ， 才 能 让 Maven 正 常 运行 
你 需要 将 Maven 的 bin 目 录 ( 在 这 个 例子 中 是 /usr/local/maven/bin) 添加 
到 命令 行路 径 中 。 还 需要 设置 环境 变量 M2_HOME， 让 它 指 向 Maven 安 
装 的 顶级 目录 〔 在 这 个 例子 中 是 /usr/local/maven) 。 有 关 如 何在 各 种 不 
同 的 操作 系统 中 执行 这 些 安装 步骤 的 细节 ， 可 以 参阅 《Maven: The 
Definitive Guide》 一 书 。 


项 目的 构建 、 测 试 以 及 运行 


假设 你 已 经 从 本 书 的 网 站 由) 下载 好 了 示例 代码 ， 这 时 应 该 转 


到 ch12 示 例 目 录 ， 运 行 mvn test 命 令 。 运 行 结 果 如 图 12-2 所 示 。 


例 12-2: 告诉 Maven 测 试 我 们 的 项 目 





Smvn test 
[INFO]Scanning for projects.....@ 

















INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 





[ 

[INFO] 

task-segment: [test] 

[INFO] -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 





[INFO] [resources: resources] 
[INFO]Using default encoding to copy filtered resources. 
[INFO] [compiler: compile]@ 
[INFO]Compiling 9 source files to~\examples\ch12\target\classes 
[INFO] Preparing hibernate3: hbm2ddl 
[WARNING]Removing: hbm2ddl from forked lifecycle, to prevent 
recursive 
invocation. 
[INFO] [resources: resources] 
[INFO]Using default encoding to copy filtered resources. 
[INFO] [hibernate3: hbm2ddl{execution: generate-dd1}]® 
[INFO]Configuration XML file loaded: 
~/examples/chi2/src/main/resources/hibernate.cfg.xml 
20: 16: 05, 580 INFO org.hibernate.cfg.annotations.Version- 
Hibernate 
Annotations 3.2.0.GA 
20: 16: 05, 595 INFO org.hibernate.cfg.Environment-—Hibernate 
Sali Ur 
20: 16: 05, 598 INFO org.hibernate.cfg.Environment- 
hibernate.properties 
not found 


























































































































20: 16: 05, 599 INFO org.hibernate.cfg.Environment-—Bytecode 

provider name 
cglib 

20: 16: 05, 603 INFO org.hibernate.cfg.Environment-using JDK 1.4 
java.sql 

.Timestamp handling 
INFO]Configuration XML file loaded: 

~/examples/chl2/src/main/resources/hibernate.cfg.xml 

20: 16: 05, 684 INFO org.hibernate.cfg.Configuration-configuring 
from url: 

~/examples/chl2/src/main/resources/hibernate.cfg.xml 

20: 16: 05, 808 INFO org.hibernate.cfg.Configuration-Configured 
SessionFactory: 

null 

(schema export omitted) 

20: 16: 07, 172 INFO org.hibernate.tool.hbm2dd1.SchemaExport-schema 
export 

complete 

20: 16: 07, 173 INFO 
org.hibernate.connection.DriverManagerConnectionProvider 

-cleaning up connection pool: jdbc: hsqldb: data/music 
[INFO] [resources: testResources ] 
[INFO]Using default encoding to copy filtered resources. 
[INFO] [compiler: testCompile]® 
[INFO]Compiling 2 source files to~\examples\ch12\target\test- 
classes 

20: 16: 08, 194 INFO 
org.hibernate.connection.DriverManagerConnectionProvider 

-cleaning up connection pool: jdbc: hsqldb: data/music 
[INFO] [surefire: test]® 
[INFO] Surefire report directory: ~\examples\ch12\target\surefire- 
reports 
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Running com.oreilly.hh.ArtistTest 

Hibernate: insert into ARTIST (ARTIST ID, actualArtist ART Sel Dy, 
NAME ) 

values (null, ?, ?) 

Hibernate: call identity © 

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.345 












































sec 
Results: 
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 


这 个 命令 进行 了 很 多 活动 ， 我 们 来 看 看 刚才 发 生 了 什么 : 


























QKE, mv test 是 什么 意思 ? 在 命令 行 中 ， 我 们 调用 Maven， 并 向 
它 传 递 Maven 构 建生 命 周期 (Maven Build Lifecycle) 中 目标 阶段 的 名 
称 。Maven 构 建生 命 周期 是 Maven 在 构建 项 目 时 经 历 的 一 组 阶段 。 在 生 
命 周 期 的 各 个 阶段 中 ， 需 要 为 了 执行 而 注册 不 同 的 插件 ， 在 编译 阶段 要 
对 代码 进行 编译 ， 在 测试 阶段 要 执行 各 种 测试 ， 在 打包 阶段 要 创建 JAR 
包 。 有 关 Maven 构 建生 命 周 期 各 阶段 的 完整 列表 ， 可 以 参阅 本 章 后 面 
的 “Maven 构 建 的 生命 周期 "一 节 。 








从 要 到 达 测 试 阶段 ， 必 须 先 通过 编译 阶段 。 在 编译 阶段 需要 注册 并 
运行 Maven Compiler 插 件 。Maven 插 件 是 由 不 同 的 目标 (goal) 组 成 
的 ， 我 们 可 以 看 到 执行 了 编译 目标 ， 编 译 了 9 个 源 文件 ， 生 成 的 字 节 码 
文件 放 到 了 targetclasses 中 。 我 们 如 何 判 断 编译 器 插件 已 经 执行 了 编译 
目标 ? [compiler: compile] 告 诉 我 们 这 一 信息 ， 在 Maven 的 输出 中 ， 你 
会 看 到 很 多 类 似 的 信息 。 冒 号 之 前 的 字符 串 部 分 是 插件 标识 符 〈plug-in 
identifier) ， 之 后 是 正在 被 执行 的 目标 标识 符 〈(goal identifier) 。 注 
意 ，compiler: compile 下 面 几 行 有 一 条 警告 性 质 的 日 志 语 句 ， 目 前 你 可 
以 放心 地 名 略 它 。 





























会 接着， 我们 可 以 看 到 正在 执行 的 是 Hibernate3 插 件 的 hbm2ddl 目 
标 。 这 个 插件 不 是 默认 插件 ， 必 须 在 Maven 中 明确 地 添加 这 个 插件 ， 不 
过 ， 不 必 为 它 提 供 很 多 配置 。 这 个 插件 假设 hibernate.cfg.xml 位 于 
src/main/resources 目 录 中 。 我 们 将 在 后 面 的 “使 用 Maven Hibemate3 插 


件 ” 一 节 中 详细 地 介绍 Hibernate3 Maven 插 件 。 


@@ 接 着， 编译 单元 测试 。 编 译 器 插件 有 一 个 名 为 testCompile 的 目 
标 。 编 译 好 的 测试 字 节 码 保存 在 target/test-classes 目 录 中 。 





全 最 后 ，Surefire 插 件 执行 test 目 标 ， 在 生成 的 测试 类 中 寻找 扩展 自 
JUnit 的 TestCase 类 的 测试 类 。 在 这 个 例子 中 ， 我 们 编写 了 一 个 简单 的 
JUnit 测 试 ， 向 ARTIST 表 插入 一 个 测试 值 。 


Maven 风 才 在 幕后 的 操作 束 是 编译 源 代 码 、 创 建 一 个 HSQLDB 数 据 
库 、 编 译 单 元 测试 、 运 行 一 个 单元 测试 以 便 在 数据 库 中 插入 一 行 数据 。 
如 末 你 想 重 复 该 示例 ， 删 除数 据 目录 或 单元 测试 将 导致 回 数 据 库 中 插入 
一 行 数据 时 会 失败 ， 因 为 这 样 会 违反 在 艺人 名 称 上 施加 的 惟一 性 约束 限 


制 条 件 。 为 了 清除 掉 整 个 项 目 ， 应 该 运行 mvn clean 命 令 : 








Smvn clean 
[INFO] Scanning for projects... 











[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 












































[NFO] 
task-segment: [clean] 
PINEO | 
[INFO] [clean: clean] 
[INFO] Deleting directory~\examples\ch12\target 
[INFO] Deleting directory~\examples\ch12\target\classes 
[INFO] Deleting directory~\examples\ch12\target\test-classes 
[INFO] Deleting directory~\examples\ch12\target\site 


























一 


如 果 你 打算 在 其 他 项 目 中 也 利用 这 个 项 目的 类 ， 你 可 能 希望 生成 一 
个 JAR 文 件 ， 并 将 其 保存 在 类 路 径 中 。 为 了 生成 一 个 JAR， 应 该 运行 


mvn package 命 令 : 





Smvn Packade 
INFO]Scanning for projects... 





— 
KI 
H 





[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 
[INFO]task-segment: [package] 
[ 














[INFO] [jar: jar] 
[INFO] Building jar: ~\examples\ch12\target\hib-dev-ch12-2.0- 
SNAPSHOT.jar 














我 们 对 这 个 示例 的 输出 进行 了 大 量 删 减 ， 因 为 它 与 前 面 的 mvn test 
的 输出 差不多 是 一 样 的 。 在 此 之 后 是 Jar 插 件 的 jar 构 建 目标 的 输出 ， 我 
们 显示 了 这 一 内 容 。Jar 插 件 绑 定 到 了 Maven 构 建生 命 周期 的 打包 阶段 ， 
它 创建 了 一 个 名 为 hib-dev-ch12-2.0-SNAPSHOT.jar 的 JAR 目 标 artifact。 


[1] http://www.oreilly.com/catalog/9780596517724/. 


使 用 Maven 生 成 IDE 项 目 文件 


在 上 一 节 中 ， 你 创建 了 一 个 数据 库 、 编 译 了 代码 、 对 代码 进行 了 测 
试 并 将 最 终 的 生成 结果 打包 到 JAR 中 ， 但 是 这 些 还 只 是 Maven 能 够 做 到 
的 一 部 分 。Maven 有 许多 插件 ， 不 过 它们 一 般 不 直接 附加 到 Maven 的 生 
命 周期 中 。 一 些 项 目的 一 个 常见 功能 就 是 为 集成 开发 环境 CIDE, 
Integrated Development Environment) 提供 配置 文件 。 通 常 一 个 团队 将 会 
使 用 一 种 标准 的 开发 环境 ， 如 IntelliJ、Eclipse、NetBeans 或 者 Emacs 
JDE， 为 这 些 工具 提供 的 配置 文件 也 将 是 项 目的 一 部 分 。 如 果 一 个 团队 
具有 一 套 标准 的 工具 ， 那 将 IDE 配 置 文件 保存 在 版 本 控制 工具 中 可 能 
有 意义 。 








注意 : 大 多 数 人 都 有 各 目 喜 欢 的 开发 工具 ， 所 以 ， 从 POM 中 生成 
IDE 项 目 可 以 让 每 个 人 都 使 用 他 们 觉得 最 有 效率 的 工具 。 








当 团 队 并 没有 使 用 一 套 统 一 的 工具 时 ， 在 版 本 控制 工具 中 保存 IDE 
配置 显得 没有 多 大 意义 。 就 以 大 多 数 开 源 项 目 为 例 ， 参 与 项 目的 每 个 人 
之 间 很 少 有 或 根本 没有 交流 ， 也 没有 能 力 协 调 彼此 之 间 开 发 平台 和 IDE 
的 选择 。 即 使 你 认为 不 会 有 项 目 允 许 单独 的 开发 人 员 可 以 独立 地 选择 目 
己 的 开发 工具 集 ， 从 Maven 中 生成 IDE 配 置 文件 也 有 一 定 的 好 处 。 这 些 
配置 文件 通 第 都 包含 了 同样 的 依赖 信息 、 标 识 符 以 及 设置 ， 可 以 将 这 些 














信息 保存 在 pom.xml 文 件 中 。 如 果 不 从 pom.xml 中 生成 IDE 配 置 ， 束 必须 
保存 和 维护 多 份 这 些 信息 的 复 本 。 





为 了 生成 一 套 Edlipse 配 置 文件 ， 可 以 从 ch12 示 例 目 录 中 运行 mvn 


eclipse: eclipse 命 令 : 





Smvn eclipse: eclipse 
[INFO] Scanning for projects... 
[INFO] Searching repository for plugin with prefix: 'eclipse'. 


























[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 
[INFO]task-segment: [eclipse: eclipse] 














[INFO]Preparing eclipse: eclipse 
[INFO]No goals needed for project-skipping 
[INFO] [eclipse: eclipse] 
INFO]Using source status cache: ~\examples\ch12\target\mvn- 
eclipse-cache 

-properties 
INFO]Wrote settings to~ 
\examples\ch12\.settings\org.eclipse.jdt.core.prefs 
[INFO]Wrote Eclipse project for"hib-dev-ch12"to~\examples\ch12. 
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Maven 只 是 使 用 pom.xml 中 的 信息 来 生成 项 目 目录 中 的 Eclipse 项 目 
文件 〈.project 和 .classpath 配 置 文件 ) 。 要 将 生成 的 项 目 导 入 到 Eclipse 
中 ， 在 Eclipse 中 选择 File > Import (GA) 菜单 选项 ， 在 Import 对 话 框 
中 ， 展 开 General 〈 普 通 ) 部 分 ， 选 择 "Existing Projects into 
Workspace"〈 导 入 现 有 的 项 目 到 工作 空间 ) ， 再 点 击 "Next" 按 钮 。 在 接 
下 来 的 界面 中 通过 浏览 器 导航 到 示例 目录 ， 并 选择 示例 的 根 目 录 ， 再 点 


击 "Next" 按 钮 。Eclipse 这 时 就 会 在 所 选择 的 目录 及 其 所 有 子 目 录 中 搜 
索 .project 文 件 。 在 成 功 导入 项 目 以 后 ， 还 需要 添加 一 个 名 为 M2_REPO 
的 Java Classpath 变 量 ， 让 它 指 向 一 /m2/repository。 为 此 ， 打 开 Eclipse 的 





Preferences 设 置 ， 在 Java/Build Path/Classpath Variables 节 点 下 ， 你 可 以 
看 到 包括 ECLIPSE_HOME 在 内 的 一 列 已 经 有 的 Classpath Variables (类 
路 径 变 量 ) 。 添 加 一 个 名 为 M2_REPO 的 新 Classpath Variable， 并 让 它 指 
同 你 的 本 地 Maven2 仓 库 ， 在 这 个 例子 中 应 该 是 ~/.m2/repository。 








只 需要 添加 一 次 M2_REPO 类 路 径 变量 ， 而 且 如 果 你 不 喜欢 通过 
Eclipse Preferences 来 添加 类 路 径 变 量 的 方法 ， 也 可 以 使 用 Maven Eclipse 
插件 将 类 路 径 变量 添加 到 你 的 Eclipse 工作 空间 中 ， 如 下 所 示 : 





/home/tobrien$mvn-o eclipse: add-maven-repo\ 
-Declipse.localRepository=~/.m2/repository\ 
-Declipse.workspace\=~/eclipse 














本 书 所 有 章节 的 示例 都 包含 了 一 个 pom.xml 文 件 ， 但 它们 并 非 都 完 
全 兼容 Maven。 不 过 ， 在 每 一 草 中 有 一 件 事 ， 你 可 以 放心 地 去 做 ， 那 就 
是 使 用 mvn eclipse: _ eclipse 命令 来 生成 Eclipse 项 目 文件 。 试 一 下 ! 再 换 
到 其 他 章 的 示例 目录 ， 运 行 mvn eclipse: eclipse， 再 导入 那 一 章 到 
Eclipse 中 。 或 者 ， 如 果 你 想 为 所 有 章节 一 次 性 地 生成 Eclipse 项 目 文件 ， 
则 可 以 先 转 到 所 有 章节 示例 的 父 目 录 ， 再 从 那里 运行 run mv eclipse: 
eclipse 命 令 。 从 examples 目 录 运 行 该 命令 将 会 为 所 有 子 模块 执行 Eclipse 
插件 的 eclipse 构 建 目 标 ， 每 一 章 的 代码 示例 都 有 一 个 eclipse 构 建 目标 。 

















除了 Eclipse 项 目 ， 你 也 可 以 为 IntelliJ 的 Idea IDE 生 成 项 目 配置 。 为 
此 ， 可 以 按 以 下 方式 执行 Idea 插 件 的 idea 构 建 目标 : 





Smvn idea: idea 
[INFO] Scanning for projects... 
[INFO] Searching repository for plugin with prefix: 'idea'. 

















[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 
[INFO]task-segment: [idea: idea] 
[ 


























NFO] ------------------------------------------------------------ 
[INFO]Preparing idea: idea 
[INFO]No goals needed for project-skipping 
[INFO] [idea: idea] 
[INFO] jdkName is not set, using[java versionl.6.0 02]as default. 








idea 构 建 目标 会 在 项 目 目录 中 创建 3 个 文件 : hib-dev-ch12.iml, hib- 
dev-ch12.ipr 以 及 hib-dev-ch12.iws， 用 这 些 文件 就 可 以 将 该 项 目 导 入 到 
Idea J 。 


用 Maven 生 成 报告 


我 们 已 经 构建 了 一 个 项 目 ， 现 在 准备 生成 一 些 简单 的 报告 。 一 种 可 
能 的 报告 形式 就 是 用 于 显示 单元 测试 结果 的 HTML 页 面 。 测 试 成 功 还 是 
失败 了 ? 哪些 测试 失败 了 ? 你 也 可 以 为 代码 提供 JavaDoc， 对 代码 添加 
标注 ， 以 方便 碍 向 。 所 有 这 些 都 生成 好 以 后 ， 可 以 运行 命令 mvn site: 











Smvn site 
[INFO] Scanning for projects... 
[二 








[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 
[INFO]task-segment: [site] 


























[INFO]Setting property: classpath.resource.loader.class= 

>'org.codehaus 
.plexus.velocity.ContextClassLoaderResourceLoader' 

[INFO]Setting property: velocimacro.messages.on=>'false' 

[INFO]Setting property: resource.loader=>'classpath'. 

[INFO]Setting property: resource.manager.logwhenfound=>'false' 

[INFO] KEK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KK KKK KKK KKK KK KKK KK KKK KKKKKKKK 

[INFO]Starting Jakarta Velocity v1.4 

[INFO] [site: site] 

Constructing Javadoc information... 

Standard Doclet version 1.6.0 02 

Building tree for all the packages and classes... 

Generating~/examples/ch12/target/site/apidocs\index.html.... 

[INFO]Generate"Source Xref"report. 

[INFO]Generate"Continuous Integration"report. 

[INFO] Generate"Dependencies"report. 

[INFO]Generate"Issue Tracking"report. 

[INFO]Generate"Project License"report. 

[INFO]Generate"Mailing Lists"report. 

[INFO]Generate"About"report. 


























































































































INFO 
INFO 
INFO 
INFO 


Generate"Project Summary"report. 
Generate"Source 


Repository"report. 
Generate"Project Team"report. 
Final Memory: 23M/42M 











rs een ee rt 
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以 上 输出 片段 有 相当 多 的 删 减 。 如 果 你 运行 mvn site， 将 能 够 看 到 
页 面 和 活动 的 页 面 。Maven 创 建 了 一 个 项 目 网 站 ， 并 生成 了 一 些 有 用 的 
报告 。 以 下 我 们 快速 浏览 一 下 结 
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图 12-1 生成 Maven 的 网 站 


Maven 生 成 的 简单 网 站 上 列 出 了 许多 与 项 目 有 关 的 报告 和 页 面 。 虽 
然 默 认 的 网 站 模板 看 起 来 不 算 太 好 ， 如 图 12-1 所 示 ， 但 它 确 实 提供 了 一 
个 基本 的 网 站 ， 你 可 以 此 为 基础 来 在 线 发 布 有 关 项 目的 信息 。 如 末 项 目 
的 POM 配 置 正 确 ， 就 可 以 生成 一 个 简单 的 页 面 ， 列 出 了 项 目的 成 员 、 许 











可 协议 以 及 一 个 指向 问题 管理 工具 〈 如 Bugzilla、JIRA 或 Trac) 的 链 
接 。 如 果 你 正在 创建 一 个 开源 项 目 ， 这 些 信息 足以 构成 一 个 公共 的 、 面 
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目 ， 这 样 的 网 站 对 开发 团队 来 说 也 是 有 用 的 。 





默认 Maven 了 网 站 的 感 观 风 


格 有 许多 需要 改进 之 处 ， 可 以 使 用 保存 在 src/site 目 录 下 的 样式 表 
(stylesheets) 和 模板 来 进行 定制 。 如 果 点 击 导 航 菜 单 左边 的 Project 


HE y oh ae, HE WA 
Reports《〈 项 目 报告 ) 链接 ， 就 可 以 看 到 一 些 有 用 的 报告 。 还 可 以 浏览 项 
目的 JavaDoc， 如 图 12-2 所 示 。 
AN cl com oreilly hh data 
85565 = 

Class Artist 

Packages 

com orealy hh yava.lang.ob ect 

com, oreilly hh date Leom. oreilly.hh. data. Artist 

All Classes 

Album public class Artist 

AlbumTest extends java.lang.Object 

Album Track 

Artist 

CreateTest 

QueryTest i 

ee Constructor Summary 

SiereoVolume Artist () 

Track 
Artist (java.lang.String name, JaVa.util HashSet«<Track> tracks, 
Artist actualArctist) 


图 12-2 网 站 内 的 项 目 JavaDoc 页 面 


反击 Surefire 报 告 链 接 ， 就 可 以 浏览 单元 测试 的 结果 如 图 12-3 所 
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Project 
Documentation 
+ Project Information Su m ma ry 


+ Project Reports 


JavaDocs 


Maven Surefire [Summary] [Package List][Test Cases) 
Report | 
Source xref i 
Test Javabocs 1 0 0 0 100% 1.275 
uit DY | Note: failures are anticipated and checked for with assertions whia errors are 
maven unanticipated. 
Package List 
[Summary] [Package List][Test Cases] 
com. orailhy hh 1 0 o 0 100% 1.275 


Note: package statistics are mot computed recursively, they only sum up all of its 
testsuites numbors- 


com.oreilly.hh 


wh ArtistTest 1 [i] Li a 100 1.275 


图 123 项 目的 单元 测试 结果 页 面 


因为 这 个 项 目 只 定义 了 一 个 单元 测试 ， 所 以 Surefire 报 告 没 有 多 少 
内 容 。 如 果 项 目 中 包含 了 大 量 的 测试 ， 就 可 以 在 这 个 报告 中 检查 代码 的 
总 体质 量 。 如 果 发 现 单元 测试 有 问题 ， 或 者 如 果 想 查找 代码 中 特定 的 某 
一 错误 ， 就 可 以 使 用 JXR 报 告 来 浏览 经 过 标注 的 、 交 叉 引 用 Ccross- 
referenced) 的 源 代码 (如 图 12-4 所 示 )。 


import java.sql.Time; 


H ka bx 





S 
All Classes j 
L 10 dmport java.util.*; 
wi 11 
Packages iS gisi 
13 “ Create sample data, letting Hibernate persist it for us. 
com.oreillyhh ~ |14 */ 
二 | 加 | > 15 public class CreateTest { 
— | 16 
i? fter 
All Classes 28 + Löök up an artist record given 4 name. 
19 “ param name the name of the artist desired. 
Album 20 + @param create controls whether a new record should be crea 
AlbumTest 2l * the specified artist is not yet in the database. 
AlbumTrack 22 + param session the Hibernate session that can retrieve dat 
Artist 23 + @return the artist with the specified name, or <code>null< 
RS 24 * such artist exists and <code>create</code> is <coc 
e me 25 * @throws HibernateException if there is a problem. 
25 26 * 
QueryTest i 26 d 
SourceMedia 27 public static Artist getArtist(S5tring name, boolean create, S 
StereoVolume 28 throws HibernateException 
Track 29 { 
320 Query query = session. getnNamedguery ("com.oreilly.hh. artiste 
31 query.setstring ("name", name); 
32 Artist found = (Artist}gquery.uniqueResult():; 
EE if (found == null 66 create) | 


12-4 交叉 引用 的 HIML 源 代码 


X 


在 查看 代码 时 ，JXR 报 告 很 有 用 。 还 有 很 多 其 他 报告 可 以 使 用 ， 例 
如 ， 用 Clover 报 告 测试 的 履 盖 度 ， 以 及 JDepend 报 告 、DocBook、PDF 生 








这 里 我 们 不 打算 详细 介绍 Maven 的 工作 原理 ， 只 是 进行 了 编译 、 构 
建 数据 库 、 测 试 、 打 包 、 对 某 个 简单 的 示例 代码 进行 文档 化 。 在 下 一 市 
中 ， 我 们 将 看 看 让 这 一 切 都 成 为 可 能 的 文件 ，pom.xml。 这 样 ， 对 
Maven 的 配置 和 定制 ， 你 才 会 有 一 定 的 感觉 。 


Maven 项 目 对 象 模 型 


项 目 对 象 模型 (Project Object Model) 是 Maven 的 核心 ， 它 是 运行 
Maven 惟 一 需要 的 配置 文件 。 每 个 Maven 项 目 都 有 一 个 pom.xml 文 件 ， 它 
描述 了 项 目的 属性 和 依赖 关系 ， 以 及 任何 自 定义 的 构建 配置 。 例 12-3 演 
示 了 文 持 前 面 项 目 构建 的 pom.xml 文 件 内 容 。 





例 12-3: Maven 项 目 对 象 模型 (POM) 





<project xmlns="http://maven.apache.org/POM/4.0.0"@ 
xmins: xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi: schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.oreilly.hh</groupId>@ 
<artifactId>hib-dev-chi2</artifactId> 
<version>2.0-SNAPSHOT</version> 

<name>Harnessing Hibernate: Chapter Twelve: Maven</name> 
<packaging>jar</packaging>@® 

<dependencies>@ 

<dependency> 

<groupId>junit</grouplId> 
<artifactId>junit</artifactId> 
<version>3.8.1</version> 

<scope>test</scope> 

</dependency> 

<dependency> 

<groupId>hsqldb</groupiId> 
<artifactId>hsgqldb</artifactId> 
<version>1.8.0.7</version> 

</dependency> 

<dependency> 

<grouplId>org.hibernate</groupid> 
<artifactId>hibernate</artifactId> 
<version>3.2.5.ga</version> 

<exclusions> 











































































































<exclusion> 
<grouplId>javax.transaction</grouplId> 











<artifactl 

















[d>jta</artifactId> 


</exclusion> 
</exclusions> 
</dependency> 
<dependency> 














































































































<groupld>org.apache.geronimo.specs</grouplId> 
<artifactId>geronimo-jta_ 1.1 spec</artifactId> 
<version>1.1</version> 

</dependency> 

<dependency> 

<groupId>log4j</groupId> 
<artifactId>log4j</artifactId> 
<version>1.2.14</version> 

</dependency> 

<dependency> 

<grouplId>org.hibernate</groupid> 
<artifactId>hibernate-annotations</artifactId> 
<version>3.3.0.ga</version> 

</dependency> 

<dependency> 

<groupld>org.hibernate</groupid> 
<artifactId>hibernate-commons-annotations</artifactI 
<version>3.3.0.ga</version> 

</dependency> 

</dependencies> 

<build> 


<extensions>®@® 
<extension> 
<groupId>hsqldb</groupiId> 














<artifactl 














[d>hsqldb</artifactId> 








<version>1.8.0.7</version> 
</extension> 

<extension> 
<groupId>1log4j</groupId> 




















<artifactl 

















d>1log44,</artifactId> 





<version>1.2.14</version> 





</extension> 
</extensions> 





lugins> 








lugin>@® 





<groupId>org.apache.maven.plugins</groupid> 








<artifactl 

















factI 





[d>maven-compiler-plugin</artii 


<configuration> 
<source>1.5</source> 
<target >1.5</target> 
</configuration> 




















d> 


d> 


</plugin> 
<plugin>@ 








<groupId>org.codehaus.mojo</groupliId> 
<artifactId>hibernate3-maven-plugin</artifactId> 
<version>2.0</version> 











<executions> 
<execution> 
<id>generate-ddl</id> 














<phase>process-classes</phase> 


<goals> 
<goal>hbm2dd1</goal> 
</goals> 
</execution> 
</executions> 
</plugin> 
</plugins> 
</build> 
<reporting>® 
<plugins> 
<plugin> 



































<artifactId>maven-javadoc-plugin</artifactId> 


</plugin> 
<plugin=> 











<groupId>org.codehaus.mojo</groupliId> 
<artifactId>jxr-maven-plugin</artifactId> 














</plugin> 
<plugin=> 
<artifactId>maven-sure! 



































factI 





</plugin> 
</plugins> 
</reporting> 
</project> 





fire-report-plugin</artii 


d> 





这 就 是 我 们 编译 、 测 试 、 生 成 Web 网 站 时 需要 提供 的 所 有 配置 : 


@ 驻 档 元 素 是 project。 我 们 采用 xsi: schemaLocation 来 定义 Maven 
如 果 你 想 全 面 地 了 解 引用 的 这 个 Schema， 
可 以 把 它 加 载 到 类 似 XMLSpy 的 工具 中 ， 这 个 Schema 的 文档 注释 一 目 了 


POM 第 4 版 的 XML Schema。 


然 


JAY O 


四 接着 ， 我 们 定义 了 一 组 每 个 Maven 项 目 都 可 以 公用 的 标识 符 : 
groupId、artifactId 以 及 version。 这 三 个 属性 相当 于 Maven 项 目的 惟一 “ 坐 
标 ”。 在 这 个 POM 的 全 部 内 容 中 ， 你 会 注意 到 各 种 依赖 、 扩 展 以 及 插件 
都 引用 了 这 三 个 属性 中 的 一 个 或 多 个 。 


个 这 个 项 目的 packaging 是 jar。 将 打包 格式 设置 为 jar， 就 告诉 Maven 
这 个 项 目的 构建 结果 应 该 生成 一 个 JAR 文 件 。Maven 支 持 一 套 预定 的 打 
包 格 式 ， 例 如 pom、jar 以 及 war。 如 有 果 在 POM 中 没有 声明 packaging 元 
素 ， 其 默认 值 就 是 jar。 


@dependencies 元 素 告 诉 Maven 这 个 项 目 需要 依赖 什么 样 的 外 部 库 文 
件 。Maven POM 中 的 dependencies 与 我 们 一 直 在 用 的 Maven Ant Task 中 
的 dependencies 完 全 一 样 。 如 果 将 这 个 pom.xml 中 的 dependencies 的 内 容 
与 build.xml 的 对 应 内 容 进行 比较 ， 你 会 发 现 这 里 包括 的 依赖 与 第 7 章 的 
build.xml 中 的 依赖 是 一 样 的 : JUnit、HSQLDB、Hibernate (ir 








JTA) 、Apache Geronimo 中 的 JTA 以 及 Hibernate Annotations. 


@build 元 素 是 我 们 定义 构建 的 地 方 。 在 这 个 地 方 我 们 能 够 为 插件 配 
置 自 定义 的 行为 ， 以 及 配置 Maven 默 认 安 装 中 可 能 没有 提供 的 插件 。 因 
为 准备 将 Hibernate3 插 件 配置 为 使 用 HSQLDB， 上 所 以 在 build 元 素 下 的 
extensions 添 加 了 hsqldb 和 1log4j 库 。extension 元 素 的 内 容 是 任何 在 插件 执 
行 期 间 需 要 在 类 路 径 上 出 现 的 依赖 的 groupId、artifactId 以 及 version 值 。 











@@ 第 一 个 plugin 元 素 是 配置 编译 器 插件 ， 让 它 使 用 兼容 Java 5 的 源 代 
码 和 目标 文件 。 


@ 这 里 我 们 对 Codehaus ( 11) 的 Mojo 项 目 中 的 Hibernate3 Maven 插 
件 进 行 配置 。 在 编写 本 书 时 ，Hibernate3 插 件 的 最 新 发 行 版 本 是 2.0。 这 
一 插件 配置 标明 了 hibernate.cfg.xml 的 公共 位 置 ， 也 添加 了 一 个 属性 来 告 
Yehbm2ddl: 当 生 成 数据 库 模 式 时 不 要 删除 已 有 的 数据 库 。 基 于 Ant 的 例 
子 会 在 编译 完成 之 后 的 构建 期 间 执 行 hbbm2ddl 目 标 ， 而 POM 则 是 将 
hbm2ddl 放 在 Maven 的 process-classes 阶 段 执行 。 我 们 将 在 本 章 后 面 
的 “Maven 构 建 的 生命 周期 "一 节 中 再 详细 介绍 Maven 构 建生 命 周 期 中 的 
各 个 阶段 。 











全 最 后 ，reporting 区 上 段 配置 在 网 站 生成 阶段 要 执行 的 报告 (report) 
生成 器 。 用 于 生成 报告 的 Maven 插 件 有 一 个 report 目 标 ， 在 网 站 生成 过 程 
中 会 调用 这 个 目标 。 为 了 包括 报告 ， 必 须要 在 reporting 元 素 下 包括 相应 
的 插件 。 


注意 这 种 pom.xml 文 件 和 其 他 章节 的 build.xml 文 件 的 区 别 。 在 
build.xml 中 ， 我 们 需要 明确 地 告诉 Ant 要 做 什么 ， 在 哪 和 什么 时 间 进 行 
操作 ， 怎 么 保存 结果 。 在 Maven 中 ， 我 们 只 需要 指出 依赖 和 说 明 需 要 执 
行 的 目的 。Maven 插 件 知道 应 该 怎么 做 ， 负 责编 译 的 插件 会 查找 
src/main/java 目 录 下 的 源 文件 和 src/test/java 目 录 下 的 测试 代码 。 
Hibernate3 插 件 “ 知 道 ” 我 们 的 hibemate.cfg.xml 文 件 应 该 放 在 





src/main/resources 目 录 中 。 如 果 我 们 将 hibernate.cfg.xml 文 件 保 存 到 不 同 
的 位 置 ， 就 得 告诉 插件 这 一 情况 ， 但 是 ， 为 什么 要 不 辞 辛 苦 地 修改 默认 
的 约定 ， 又 有 什么 意义 呢 ? 本 章 稍 后 会 在 12.8 贡 仔细 看 看 Hibernate3 插 

| 











父 / 子 项 目 对 象 模型 


本 章 的 示例 使 用 的 是 一 个 单独 pom.xml， 以 简化 对 Maven 的 介绍 ， 
而 其 他 各 章 的 示例 采用 的 是 所 谓 的 多 模块 (multi-module〉 Maven 项 
目 ， 在 这 种 模型 中 ， 每 一 个 子 模块 (submodule〉 需 要 依赖 一 个 父 模 
块 。 我 们 以 第 7 章 为 例 ， 在 ch07 目 录 中 ， 你 可 以 找到 一 个 pom.xml 文 件 ， 
其 内 容 如 例 12-4 所 示 。 这 里 需要 注意 的 第 一 件 事 就 是 这 个 文件 这 么 小 ， 
它 的 所 有 依赖 是 在 哪 定义 的 ? 











例 12-4: 第 7 章 的 pom.xml 文 件 





<?xml version="1.0"encoding="UTF-8"?> 

<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns: xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi: schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4 0 0.xsd"> 

<parent> 

<groupId>com.oreilly.hh</groupId>@ 
<artifactId>hib-dev-parent</artifactId> 
<version>2.0-SNAPSHOT</version> 

</parent> 

<modelVersion>4.0.0</modelVersion> 
<artifactId>hib-dev-ch7</artifactid>@ 
<packaging>jar</packaging>@® 

<name>Harnessing Hibernate: Chapter Seven</name> 
























































<version>2.0-SNAPSHOT</version> 
<build=> 

<plugins> 

<plugin> 
<groupId>org.codehaus.mojo</groupld> 
<artifactIid>hibernate3-maven-plugin</artifactId> 
<version>2.0-alpha-3-SNAPSHOT</version> 
<executions> 

<execution> 

<id>generate-ddl</id> 
<phase>process-classes</phase> 

<goals> 

<goal>hbm2dd1</goal> 

</goals> 

</execution> 

</executions> 

<configuration> 

<components> 

<component > 

<name>hbm2dd1</name>@ 
<implementation>annotationconfiguration</implementation> 
</component > 

</components> 

</configuration> 

</plugin> 

</plugins> 

</build> 

<dependencies>@ 

<dependency> 
<grouplId>org.hibernate</groupid> 
<artifactId>hibernate-annotations</artifactId> 
<version>3.3.0.ga</version> 
</dependency> 

<dependency> 
<grouplId>org.hibernate</groupid> 
<artifactId>hibernate-commons-annotations</artifactId> 
<version>3.3.0.ga</version> 
</dependency> 

</dependencies> 

</project> 

</project> 























































































































这 个 pom.xml 从 表面 上 看 起 来 相当 简单 ， 因 为 它 的 配置 大 部 分 都 继 
承 自 父 项 目的 POM《〈 稍 后 再 介绍 ) 。 我 们 先 来 看 看 这 个 简单 的 POM 的 


内 容 : 


人 @@ 我 们 先 把 这 个 项 目 链接 到 一 个 父 项 目 上 ， 由 groupId、artifactId 以 
及 version 这 三 个 属性 来 定义 该 父 项 目 。 在 Maven 中 定义 的 所 有 项 目 都 具 
有 这 三 个 属性 ， 它 们 是 一 个 Maven 项 目的 惟一 “坐标 >。 父 项 目 将 在 下 一 
个 例子 中 再 介绍 ， 不 过 ， 现 在 你 只 需要 知道 examples/ch07/pom.xml 继 承 
了 examples/pom.xml 中 定义 的 所 有 属性 就 可 以 了 。 





四 我 们 将 artifactId 属 性 定义 为 hib-dev-ch07。 此 处 改写 了 父 POM 中 的 
相应 属性 ， 为 这 个 项 目 提供 了 一 个 惟一 的 值 。 如 前 所 述 ， 所 有 项 目 必须 
具有 一 个 惟一 的 由 groupId、artifactId 以 及 version 构 成 的 组 合 ， 这 样 可 以 
确保 例 ch07 具 有 一 个 惟一 的 artifacttd。 注 意 ， 这 个 pom.xml 并 没有 定义 
groupId， 因 为 它 会 继承 父 pom.xml 中 的 groupId。 


个 接 下 来 ， 我 们 改写 了 这 个 项 目的 POM 的 packaging 属 性 。Maven 有 
一 套 预 定义 的 打包 格式 ， 例 如 pom、jar 以 及 war。 将 例 ch07 的 打包 格式 
修改 为 jar， 束 告诉 Maven: 这 个 项 目 期 望 它 的 构建 结果 是 生成 JAR 文 
件 。 





四 这 一 行 是 在 配置 Maven Hibernate3 插 件 ， 类 似 于 我 们 在 本 章 示例 
目录 中 进行 过 的 处 理 。 这 里 不 同 的 是 ， 我 们 正在 配置 Hibernate3 插 件 ， 
让 它 使 用 基于 标注 的 配置 方式 ， 第 7 章 介 绍 的 全 部 是 有 关 标 注 的 内 容 。 
这 一 配置 将 会 从 一 套 保 存在 srcomain/java 中 的 带 有 标注 的 模型 类 中 抽取 


Hibernate 的 映射 信息 。Maven 先 将 Java 源 文件 编译 到 target/classes 目 录 
H, Maven Hibernate3 插 件 再 扫描 生成 的 字 节 码 文 件 ， 查 找 其 中 的 
@Entity 标 注 。 最 后 ，hbm2ddl 目 标 再 用 这 些 上 映射 信息 生成 HSQLDB 数 据 
库 。 





全 我 们 声明 这 个 子 模块 的 依赖 为 Hibernate Annotations 和 Hibernate 
Commons Annotations。 这 些 新 的 依赖 会 添加 到 父 项 目 定义 的 任何 依赖 
当中 。 


第 7 章 的 POM 引 用 了 一 个 父 POM， 那 这 个 父 POM 是 在 哪 定 义 的 ? 转 
到 ch07 的 父 目 录 ， 你 会 看 到 也 有 一 个 pom.xml 文 件 〈 文 件 体积 要 大 很 

。 在 这 个 文件 中 就 定义 了 供 其 他 各 章 示 例 的 POM 所 共享 的 所 有 属 
性 。 我 们 来 看 看 这 个 父 pom.xml， 其 内 容 如 例 12-5 所 示 。 








例 12-5: 共享 的 顶级 pom.xml 








<?xml version="1.0"encoding="UTF-8"?> 

<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins: xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi: schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4 0 0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.oreilly.hh</groupId>@ 
<artifactId>hib-dev-parent</artifactId> 
<packaging>pom</packaging>@ 
<name>Harnessing Hibernate: Parent Project</name> 
<version>2.0-SNAPSHOT</version> 

<modules>® 

<module>ch01</module> 

<module>ch02</module> 

<module>ch03</module> 

<module>ch04</module> 












































<module>ch05</module> 
<module>ch06</module> 


<mod 
<mod 
<mod 


le>ch07</modul 
le>ch08</modul 
le>ch09</modul 
e>chl]l 


le> 
le> 
le> 


0</module> 





<mod 


le>chl 


1</module> 





<mod 


le>chl 


2</module> 





u 
u 
u 

<modu]l 
u 
u 
u 


<mod 


le>chl 


3</module> 














<modul] 


e>chl 














4</module> 





</modules> 


<build> 


<extensions>@ 
<extension> 


<groupId>hsqldb</groupI 
fFactid>hsgqldb</arti 

















<arti 





d> 








factI 


d> 








<version>1.8.0.7</version> 
</extension> 
<extension> 


a>] 





<group 

















<artifactlI 





og4j </groupI 








<version>] 


d> 











d>log44</artifactlI 


.2.14</version> 





</extension> 
</extensions> 
<resources> 





<resource> 


d> 


<directory>sre</directory>@ 





</resource> 
</resources> 





<sourceDirectory>srce</sourceDirectory> 


lugins> 
<plugin=> 








<grouplId>org.apache.maven.plugins</groupI 
FactId>maven-compiler-plugin</artif 
figuration> 
<source>1. 
<target>1. 





<ar 
<con 








ti 

















d> 
actl 














5</source> 
5</target> 


</configuration> 


</plugin> 
<plugin=> 





<groupId>org.codehaus.mojo</groupl 
<artifactId>hibernate3-maven-plugin</artifactI 











<version>2.0</version> 
<configuration> 
<components > 
<component > 
<name>hbm2java</name> 








<implementation>conft 





[da> 

















a>@ 


d>@ 


fFiguration</implementation> 


</component 


</componen 
<component 


> 
ts> 
Properties> 





<drop>false</drop> 














tionfile> 





<configura 





src/hibernate.cfg.xml 





</ confi gur 





ationfile> 





<jdk5>true</jdk5> 


</componen 
</configur 
</plugin> 








tProperties> 
ation> 


</plugins> 


</build> 
<dependenc 
<dependenc 


ies>® 
y> 


<groupId>hsqldb</groupiId> 





<artifactlI 














d>hsqldb</artifactId> 











<version>1.8.0.7</version> 


</dependen 
<dependenc 





cy> 
y> 





<groupld>org.hibernate</groupid> 





<artifactlI 








d>hibernate</artifactId> 














<version>3.2.5.ga</version> 


<exclusion 
<exclusion 








s> 
> 





<groupId>javax.transaction</groupIīId> 








<artifactI 
</exclusio 
</exclusio 
</dependen 
<dependenc 











<grouplId>org.apache.geronimo.specs</groupI 
d>geronimo-jta_ 1.1 spec</artif 


<artifactlI 








d>jta</artifactId> 
n> 

ns> 

cy> 

y> 




















actl 








<version>1.1</version> 





</dependen 
<dependenc 


<groupId>] 





cy> 
y> 
og4j </groupId> 








<artifactI 








d>1log44,</artifactId> 











<version>] 








.2.14</version> 





</dependen 
</dependen 


cy> 
cies> 


</project> 


d> 


d> 








该 父 POM 包 含 的 信息 要 比 其 子 POM 多 很 多 。: 


已 定义 了 所 有 公共 的 


依赖、 目录 设置 以 及 每 章 示 例 可 以 共享 的 插件 配置 。 再 一 次 ， 我 们 一 部 
分 一 部 分 地 看 看 这 个 父 POM: 


@groupId 元 素 用 于 定义 供 所 有 子 项 目 共享 的 group 标 识 符 。groupId 
的 标准 命名 习惯 是 使 用 一 个 反 向 的 完全 限定 的 域名 (你 自己 的 域名 ， 或 
是 与 项 目 相关 的 域名 ) ， 其 后 再 跟 上 特定 领域 的 标识 符 。 如 果 你 想 在 
Maven 仓 库 中 发 布 自己 的 artifact， 这 样 的 命名 规则 就 特别 重要 。 


四 在 父 POM 中 ， 将 packaging 设 置 为 pom。 这 意味 着 这 个 项 目的 存在 
只 是 为 了 提供 POM， 这 个 项 目 不 会 提供 任何 JAR 文 件 或 WAR 文 件 ， 它 
只 提供 POM。 








全 父 FOM 定 义 了 modules 列 表 。 这 部 分 列 出 了 每 章 的 示例 目录 ， 每 
个 目录 中 都 包含 一 个 pom.xml 文 件 。 如 果 你 查看 这 些 目 录 ， 就 会 发 现 其 
中 的 每 个 pom.xml 文 件 都 引用 了 这 个 父 POM。 在 父 POM 中 指定 所 有 的 模 
块 ， 就 可 以 让 我 们 能 够 一 次 性 地 构建 所 有 章节 〈 或 模块 ) 的 项 目 。 





@axtensions 元 素 用 于 配置 各 插件 使 用 的 类 路 径 。 父 pom.xml 定 义 的 
extensions 与 例 12-3 中 的 相同 。 


加 此 处 ， 我 们 正在 定制 项 目的 类 路 径 资源 〈resource) 的 位 置 。 在 
通常 的 Maven 项 目 中 ， 我 们 不 需要 定义 这 个 属性 ， 而 是 依赖 其 默认 值 
${basedir}/src/main/resources (${basedir} 是 包含 pom.xml 文 件 的 目录 ) 。 
在 本 书 中 (因为 这 是 本 关于 Hibernate 的 书 ， 而 不 是 专门 介绍 Maven 





的 ) ， 我 们 要 将 Maven 构 建 应 用 到 现 有 的 章节 示例 上 ， 所 以 需要 将 类 路 
径 资源 定义 为 sw。 除了 定义 类 路 径 资源 的 位 置 ， 我 们 也 需要 定义 源 代 
码 的 位 置 。 在 标准 的 Maven 项 目 中 ， 我 们 应 该 不 用 在 pom.xml 中 定义 这 
个 属性 ， 而 是 使 用 默认 值 ${basedir}/src/main/java。 


@ 这 一 部 分 用 于 将 编译 器 插件 配置 为 Java 5 目标 。 


@Hibernate3 插 件 是 通过 几 个 全 局 选项 来 配置 的 。 将 drop 设 置 为 
false， 会 让 hbm2ddl 目 标 不 删除 已 有 的 数据 库 。 将 jdk5 设 置 为 tue， 会 让 
hbm2java 目 标 生 成 文 持 Java 5 泛 型 的 模型 类 属性 〈 例 如 使 用 Set< Album 
>, MARÆSet) 。 我 们 也 可 以 用 configurationFile 来 配置 
hibernate.cfg.xml 的 默认 位 置 〈 如 果 该 文件 不 在 Maven 的 预想 位 置 上 ) 。 
hbm2java 的 component 项 中 ， 将 implementation 设 置 为 configuration， 这 意 
味 着 默认 行为 将 是 扫描 主 资源 目录 ， 以 查找 .hbm.xml 映 射 文件 。 我 们 在 
例 12-4 中 看 到 过 ，ch07 的 pom.xml 改 写 了 hbm2ddl 组 件 的 这 一 配置 ， 使 其 
采用 标注 来 作为 Hibernate 的 配置 方式 。 


@@ 最 后 ， 顶 级 的 POM 定 义 了 一 组 供 所 有 章节 的 例子 共享 的 依赖 。 它 
们 是 HSQLDB 1.8.0.7、Hibernate 3.2.5.ga、Apache Geronimo 项 目的 JTA 
库 以 及 Log4j 1.2.14。 可 以 比较 一 下 这 个 dependencies 元 素 的 内 容 与 任何 
一 章 的 build.xml 脚 本 中 Maven Ant Task 的 配置 。 


以 运行 ch07 目 录 中 的 示例 来 做 为 例子 。 首 先 ， 删 除 data 目 录 〈 如 果 


存在 ) ， 再 运行 mvn install。 这 将 编译 源 代码 、 按 模型 中 的 标注 来 生成 
数据 库 模 式 、 将 ch07 中 的 示例 打包 到 一 个 JAR 文 件 中 。 在 运行 构建 过 程 
以 后 ， 就 可 以 像 原来 用 Ant 那 样 来 运行 CreateTest、QueryTest 以 及 
AlbumTest。 这 些 过 程 如 例 12-6 所 示 。 





例 12-6: 使 用 Maven 来 运行 第 7 章 的 测试 





~/examples/ch07Smvn exec: java- 
Dexec.mainClass=com.oreilly.hh.CreateTest 
[INFO] Scanning for projects... 
[INFO] Searching repository for plugin with prefix: "exec ' . 
































[INFO] Building Harnessing Hibernate: Chapter Seven 
[INFO]task-segment: [exec: java] 
[INFO] == 一 一 = 一 = 一 一 一 二 一 一 一 





[INFO]Preparing exec: java 

[INFO]No goals needed for project-skipping 

[INFO] [exec: java] 

~/examples/ch07Smvn exec: java- 
Dexec.mainClass=com.oreilly.hh.QueryTest 

[INFO] Scanning for projects... 

[INFO] Searching repository for plugin with prefix: 'exec'. 


















































[INFO]Building Harnessing Hibernate: Chapter Seven 
[INFO]task-segment: [exec: java] 
[NPO] seeeeaeeh tee n Saas See Sree SaaS eee eee ee SaaS 





[INFO]Preparing exec: java 

[INFO]No goals needed for project-skipping 
INFO] [exec: java] 

Track: "Russian Trance", 00: 03: 30 

Track: "Video Killed the Radio Star", 00: 03: 49 
Track: "Test Tone 1", 00: 00: 10 








— 


~/examp] 


Les/ch07$mvn exec: java- 





Dexec.mainC] 
(output 


lass=com.oreilly.hh.AlbumTest 
omitted) 





以 上 我 们 使 用 了 一 个 通常 不 附加 到 Maven 生 命 周 期 中 的 插件 构建 目 
标 一 exec: java。 这 个 目标 将 接受 从 命令 行 传递 的 exec.mainClass 参 数 ， 


并 执行 给 定 类 中 的 main O 方法 。 


[1] http:/ /mojo.codehaus.org/ maven-hibernate3/hibernate3-maven-plugin/. 


Maven 构 建 的 生命 周期 


在 本 章 的 前 面 几 节 中 我 们 谈 到 了 生命 周期 ， 所 以 到 目前 为 止 ， 你 应 
该 至 少 掌握 Maven 的 构建 生命 周期 中 包含 编译 、 测 试 、 打 包 、 安 装 阶 
段 。 在 例 12-3 中 ， 我 们 将 hbbm2ddl 目 标 附加 到 类 处 理 (process-classes) 
阶段 ， 同 时 指出 这 个 阶段 紧 跟 在 编译 阶段 之 后 。 如 果 所 有 这 些 看 起 来 让 
你 感到 一 头 雾 水 ， 不 要 担心 ， 我 们 将 会 简单 地 解释 生命 周期 中 的 各 个 阶 
段 和 它们 的 执行 顺序 。 当 从 命令 行 运行 Maven 时 ， 需 要 选择 指定 某 个 阶 
段 的 名 称 ， 或 者 显 式 地 执行 一 个 插件 目标 。 当 指定 了 一 个 阶段 时 ， 
Maven 将 执行 它 的 生命 周期 中 直到 该 阶段 之 前 的 所 有 阶段 (包括 这 个 指 
定 的 阶段 ) 。 在 Maven 处 理 其 构建 生命 周期 时 ， 它 会 触发 附加 到 当前 阶 
段 上 的 插件 的 目标 。 另 一 方面 ， 如 果 显 式 地 请 求 一 个 插件 目标 ， 则 
Maven 将 只 执行 那个 单独 的 插件 目标 。 


以 下 列举 了 Maven 的 所 有 生命 周期 阶段 ， 而 且 按 它们 发 生 的 顺序 进 
行 排序 。 对 于 我 们 的 示例 来 说 比较 重要 的 阶段 ， 会 解释 得 细致 些 ， 而 对 
于 其 他 不 重要 的 阶段 ， 则 将 它们 组 合 起 来 以 节省 空间 : 


validate (验证 ) 


验证 POM。 


generate-sources〈 生 成 源 代 码 ) 





生成 任何 源 代 码 。Hibernate3 插 件 有 一 个 hbm2java 目 标 ， 可 以 根据 
基于 XML 的 映射 而 生成 Java 源 代码 (就 像 我们 在 前 几 章 中 做 的 那样 〉。 
如 果 我 们 想 为 映射 生成 Java 源 代码 ， 则 可 以 将 hbbm2java 附 加 到 这 个 阶 
Be 


process-sources、 generate-resources、process-resources 〈 处 理 源 文 


件 、 生 成 资源 、 处 理 资源 ) 


除了 生成 源 代 码 ， 还 需要 处 理 源 代码 生成 的 输出 、 生 成 资源 文件 
(例如 properties 文 件 、 图 片 、 声 音 以 及 程序 包 的 其 他 非 代 码 元 素 〉 以 及 
处 理 资 源 文件 。 


compile (编译 ) 








编译 器 插件 运行 编译 目标 ， 对 编译 源 代码 根 目 录 下 的 所 有 源 代码 进 
行 编译 。 插 件 可 以 在 编译 源 代码 根 目录 中 添加 新 的 目录 ， 例 如 
Hibernate3 插 件 的 hbbm2java 目 标 就 会 根据 .hbm.xml 文 件 生成 源 代码 ， 并 
将 生成 的 源 代码 放 到 target/generated-source 目 录 中 。Hibernate3 插 件 接着 
再 将 target/generated-source 目 录 添 加 到 编译 源 代 码 根 目 录 ， 以 便 在 编译 
时 可 以 包含 新 生成 的 文件 。 


process-classes (后 处 理 编译 生成 的 类 ) 


该 阶段 对 编译 的 结果 进行 后 期 处 理 Cpost-processes) 。 我 们 已 经 将 
hbm2ddl 目 标 挂 到 了 类 的 后 期 处 理 任务 上 ， 因 为 需要 对 hbm2ddl 任 务 进行 
配置 ， 才 可 以 利用 对 象 模型 中 的 标注 ， 将 它们 编译 为 模型 类 文件 。 
Hibernate3 插 件 被 配置 为 需要 对 生成 的 字 节 码 进行 搜索 ， 以 查找 出 现 
的 "@Entity" 标 注 。 因 为 只 有 先 编译 好 了 模型 类 ， 才 可 以 进行 这 样 的 扫 
描 ， 所 以 我 们 将 这 个 目标 挂 到 了 编译 阶段 之 后 的 处 理 阶 段 。 














generate-test-sources,. process-test-sources, generate-test-resources , 


process-test-resources 


这 几 个 阶段 与 从 generate-sources 到 generate-resources 的 几 个 阶段 类 


似 ， 可 以 生成 单元 测试 及 其 需要 的 任何 资源 。 
test-compile〈 编 译 测 试 源码 至 测试 目标 目录 ) 


使 用 testCompile 目 标 ， 再 次 调用 Compiler 插 件 来 编译 测试 源 代 码 。 
对 于 我 们 的 示例 来 说 ， 这 个 它 只 是 编译 src/test/java 目 录 中 的 一 个 简单 的 
类 。testCompile 目 标 会 编译 测试 源 代码 根 目录 中 的 所 有 源 代码 。 再 说 一 
次 ， 这 并 不 是 简单 地 对 srctesUjava 中 的 所 有 代码 进行 编译 ， 因 为 在 前 面 
4 个 生命 周期 阶段 中 ， 插 件 都 有 机 会 生成 单元 测试 的 源 代码 (在 测试 源 
代码 根 目录 中 添加 目录 )。 








test (测试 ) 


Surefire 插 件 扫 描 test-compile 阶 段 生 成 的 继承 自 JUnit 的 TestCase 的 
类 ， 并 使 用 JUnit 执 行 这 些 单 元 测试 〈 也 可 以 运行 TestNG 测 试 ) 。 


prepare-package (准备 打包 ) 


在 真正 将 项 目 打包 以 前 ， 执 行 一 些 准备 处 理 。 提 供与 此 相关 的 目 


package (FJ) 


对 于 我 们 的 示例 项 目 来 说 ， 最 终 只 需要 生成 一 个 JAR 文 件 。jar 打 包 
的 默认 行为 就 是 创建 一 个 名 为 ${artifactId}-${version}.jar 的 文件 。 如 果 需 
要 的 话 ， 可 以 目 定 义 这 个 文件 名 称 。 不 过 ， 如 果 可 能 的 话 ， 尺 可 能 避免 
对 Maven 进 行 定制 ， 将 是 更 好 的 做 法 。 





pre-integration-test、integration-test、post-integration-test( 预 集成 测 


试 、 集 成 测试 、 集 成 测试 后 期 ) 


单元 测试 通常 不 需要 连接 到 数据 库 ， 事 实 上 ， 在 单元 测试 中 连接 数 
据 库 的 做 法 也 让 人 感觉 有 些 古 怪我 将 其 称 为 功能 或 集成 测试 ) 。 如 果 
你 需要 执行 一 系列 集成 测试 ， 可 以 使 用 这 3 个 阶段 来 定义 相关 的 目标 。 


verify (验证 ) 


可 以 为 验证 阶段 定义 一 些 用 于 检查 生成 的 输出 是 否 符合 质量 规范 的 


目标 。 
install (安装 ) 


在 我 们 的 项 目 中 ， 安 装 阶段 只 是 将 生成 的 artifact 复 制 到 
~/.m2/repository/${groupId}/${artifactId}/$ {version }/${artifactld}- 
${version}jar 文 件 中 。 如 果 你 正在 创建 一 套 复 杂 的 交叉 依赖 的 项 目 〈 也 
就 是 说 ， 项 目 A 定 义 了 对 一 个 具体 的 库 的 依赖 ， 而 项 目 B 也 需要 依赖 这 
个 库 ) ， 那 么 项 目 B 就 可 以 用 groupId、artifactId 以 及 version (版 本 ) 来 
定义 一 个 对 项 目 A 的 依赖 ， 当 Maven 在 构建 项 目 B 时 ， 会 尝试 在 本 地 仓库 
中 解析 项 目 A 的 artifact。 通 过 将 制品 也 安装 到 本 地 仓库 中 ，install 阶 段 就 
可 以 支持 这 一 功能 。 








deploy (部 署 ) 


用 于 将 项 目的 制品 、 网 站 、 报 告发 布 到 一 个 外 部 的 仓库 中 。 项 目 也 
可 以 利用 这 个 阶段 将 各 种 制品 发 布 到 一 个 远程 Maven 仓 库 。 远 程 Maven 
仓库 可 以 是 公共 的 或 私有 的 Maven 人 仓库， 或 者 是 企业 内 部 的 Maven 仓 
库 。 


使 用 Maven Hibernate3 插 件 


本 章 使 用 的 是 来 自 Mojo 项 目 中 的 Maven Hibernate3 插 件 (H1) ， 
Mojo 是 Codehaus 上 的 一 个 项 目 ， 它 为 开发 Maven 插 件 提供 一 个 Apache 
Software Foundation (ASF) 以 外 的 空间 。 不 像 ASF 那 样 有 很 多 规则 ， 只 
要 对 一 些 Maven 插 件 感 兴趣 就 可 以 开始 为 Mojo 做 贡献 ， 这 比 ASF 上 
Maven 项 目 中 的 那些 插件 的 开发 要 更 容易 些 。 将 Mojo 放 在 Codehaus 上 的 
另 一 个 原因 是 ， 一 些 Maven 插 件 使 用 的 技术 的 许可 协议 与 Apache 
Software License 不 兼容 。Mojo 的 插件 可 以 采用 GPL 协议 ， 而 且 可 以 按 非 
Apache Software License 发 布 。 而 在 Apache Software Foundation 中 ， 所 有 








东西 的 发 行 都 需要 采用 Apache Software License. 


为 了 使 用 Maven Hibernate3 插 件 ， 所 有 你 需要 做 的 就 是 将 例 12-7 演 
示 的 plug-in 元 素 包 括 到 项 目的 pom.xzml 文 件 中 。 


例 12-7: 使 用 Maven Hibernate3 插 件 





<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns: xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi: schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 





<build> 

<plugins> 

<plugin=> 

<groupId>org.codehaus.mojo</grouplid> 
<artifactIid>hibernate3-maven-plugin</artifactId> 





























<version>2.0</version> 
</plugin> 

</plugins> 

</build> 





</project> 


Hibernate3 插 件 定义 了 以 下 构建 目标 (也 称 为 配置 目的 的 组 件 〉: 
hibernate3: hbm2cfgxml 


基于 现 有 的 数据 库 模式 而 生成 一 个 hibernate.cfg.xml 文 件 。 可 以 使 用 
这 个 目标 为 已 有 的 数据 库 构 建 相应 的 Hibernate 配 置 。 


hibernate3:hbm2ddl 


基于 现 有 的 Hibernate 映 射 而 生成 相应 的 SQL DDL (数据 库 定义 语 
言 ) 〈 使 用 标注 或 .hbm.xml 文 件 ) 。 在 我 们 的 例子 中 ， 它 生成 的 是 一 个 
HSQLDB 数 据 库 。 





hibernate3:hbm2doc 


生成 一 个 HTML 报 告 ， 用 于 描述 Object Model (对 象 模 型 ) 、 数 据 
库 模式 以 及 如 何 将 二 者 关联 起 来 。 生 成 的 报告 的 界面 风格 与 JavaDoc 类 
人 


hibernate3:hbm2hbmxml 


根据 现 有 的 数据 库 模式 而 生成 .hbbm.xml 映 射 文档 。 如 果 你 有 一 套数 


据 库 表 ， 残 可 以 用 这 个 任务 来 生成 映射 文件 ， 再 用 下 一 个 构建 目标 来 生 


成 Java 类 。 
hibernate3:hbm2java 


根据 Hibernate 映 射 而 生成 Java 源 代码 。 这 个 构建 目标 可 以 
从 .hbm.xml 文 件 生成 Java 代 码 ， 或 者 生成 与 现 有 数据 库 中 的 数据 表 对 应 


的 Java 类 。 


有 关 Maven 搬 件 的 更 多 信息 ， 可 以 参阅 Maven 网 站 〈 呈 ) 的 在 线 文 
档 有 关 Hibernate3 Maven 插 件 的 信息 ， 还 可 以 看 看 Mojo 项 目 CP!) 。 


除了 Apache Maven 发 布 的 核心 插件 以 外 ， 人 们 还 需要 为 Maven 编 写 
自己 的 插件 ，Mojo 这 个 项 目 就 是 为 此 服务 的 。 如 果 你 有 了 关于 Maven 插 
件 的 好 想法 ， 应 该 考虑 参与 到 Mojo 项 目 之 中 。 


配置 Hibernate3 插 件 


Maven Hibernate3 插 件 提 供 了 许多 配置 点 。 以 下 列举 了 其 中 一 些 重 
要 的 配置 选项 : 


propertyfile 





如 果 在 Hibernate 配 置 文件 中 没有 指定 JDBC 连 接 信 息 ， 也 可 以 在 


database.properties 文 件 中 指定 JDBC 连 接 参 数 ， 默 认 使 用 


src/main/resources/database.properties。 
configurationfile 
Hibernate 配 置 文件 。 默 认 使 用 src/main/resources/hibernate.cfg.xml。 
jdk5 


生成 Java 5 源 代 码 。 当 生成 与 Hibernate 映 射 匹 配 的 Java 源 代码 时 ， 
文 持 使 用 泛 型 和 枚 举 类 型 。 默 认 值 是 false。 


ejb3 
生成 市 有 ejb3 标 注 的 源 代码 ， 上 默认 值 是 false。 

drop 

在 执行 hbbm2ddl 前 ， 先 删除 数据 库 表 。 默 认 值 是 false。 
create 

在 执行 hbbm2ddl 时 创建 一 个 数据 库 。 默 认 值 是 true。 
outputfilename 


为 Hibernate3 插 件 的 构建 目标 配置 输出 文件 名 。 


implementation 


配置 Hibernate 映 射 的 源 文件 。 有 效 值 可 以 是 configuration、 


annotationconfiguration、jpaconfiguration 以 及 jdbcconfiguration 。 


还 有 其 他 几 个 配置 参数 ， 如 果 需 要 完整 的 列表 ， 可 以 查阅 Maven 
Hibernate3 项 目 网 站 上 的 Component Properties ( '4!) 页面 。 


注意 : Hibernate3 插 件 目前 还 在 由 Mojo 进 行 开发 当中 ， 不 要 访 记 经 
常 查 看 项 目 网 站 上 的 更 新 信息 。 








可 以 为 某 个 组 件 (hbm2java 或 hbm2ddl) 配置 它 的 每 个 配置 点 ， 也 
可 以 为 所 有 组 件 配置 它们 的 每 个 配置 点 。 由 于 例 12-3 并 没有 提供 任何 配 
置 属性 ， 所 以 Hibernate 会 按照 默认 配置 从 .hbm.xml 文 件 中 读 取 Hibernate 
映射 。 在 例 12-4 中 ，plug-in 配 置 改 写 了 hbm2ddl 目 标的 implementation 设 
置 ， 让 Hibernate 从 类 中 的 标注 来 读 取 映射 信息 。 这 一 点 值得 再 详细 讨论 
= 








属性 implementation 有 点 特殊 ， 它 可 以 设置 Hibernate3 插 件 获得 
Hibernate 上 映射 信息 的 方式 。 有 4 种 选择 : 选择 configuration， 将 在 源 文 件 
目录 中 搜索 .hbm.xml 映 射 文件 ， 选 择 annotationcon-figuration， 将 在 编译 
过 的 类 中 搜索 Hibernate Annotations; jdbcconfiguration 利 用 反问 工程 
(reverse engineering) ， 直 接 从 现 有 的 数据 库 中 生成 Hibernate 映 射 ; 


jpaconfiguration 与 annotationconfiguration 类 似 ， 只 是 它 查找 的 是 





persistence.xml, 而 不 是 hibernate.cfg.xml 配 置 文件 。 按 照 构建 目标 运 

的 环境 ， 每 个 目标 都 有 其 默认 的 implementation 设 置 。 例 如 ， 在 JDK 1.4 

运行 环境 下 ，hbm2ddl 目 标的 默认 值 是 configuration; 而 在 Java SE 5 运行 
环境 下 ， 它 的 默认 值 就 是 annotationconfiguration。 有 关 所 有 Hibernate3 构 
建 目 标的 implementation 默 认 值 ， 可 以 参阅 Maven Hibernate3 项 目 网 站 上 

的 Component Configuration ('°!) (组 件 配置 ) WH. 





生成 Hibernate 映 射 文 档 


Maven Hibernate3 插 件 有 一 个 任务 是 可 以 为 一 套 Hibernate 上 映射 创建 
文档 。 该 文档 与 JavaDoc 类 似 ， 详 细 描 述 了 数据 库 表 的 结构 和 相应 的 
Java 模 型 对 象 。 为 了 生成 这 个 文档 ， 需 要 在 运行 install 以 后 再 运行 
Hibernate3 插 件 的 hbbm2doc 构 建 目标 : 





~/examples/ch12$mvn install 

(output omitted) 

~/examples/chi2Smvn hibernate: hbm2doc 

[INFO] Scanning for projects... 

[INFO] Searching repository for plugin with prefix: 'hibernate3'. 























[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 
[INFO]task-segment: [hibernate3: hbm2doc] 























[INFO] [hibernate3: hbm2doc] 

[INFO]using annotationconfiguration task. 

INFO]Configuration XML file loaded: 

file: /Users/tobrien/svnw/hibernate- 
book/current/examples/ch12/src/main/resources/hibernate.cfg.xml 











— 

















[INFO] src/main/resources/database.properties not found within the 
project. 

Trying absolute path. 
[INFO]No hibernate properties file loaded. 
































构建 目标 hbm2doc 执 行 完成 以 后 ， 将 会 生成 HTML 文 档 
target/hibernate3/javadoc/index.html。 在 浏览 器 中 打开 这 个 页 面 ， 就 会 看 
到 一 组 描述 Hibernate 映 射 细 节 的 HTML 文 档 。 可 以 从 数据 库 表 或 实体 的 
视图 来 浏览 Hibernate 映 射 。 从 实体 视图 (如 图 12-5 所 示 〉 可 以 查看 是 哪 
个 数据 库 表 关联 到 了 某 个 特定 实体 对 象 ， 而 数据 库 表 视图 〈 如 图 12-6 所 
AN) 则 是 先 点 击 一 个 数据 库 表 ， 再 看 看 是 哪个 实体 对 象 映射 到 了 这 个 特 
定 的 表 。 





Aa Entities 


Packages 


All Entities 


Album 
AlbumTrack 
Artist 


StereoVoume 


Track 


图 


com.oreilly .hh.data 


Entity Track 


com.orei lly. hh.data.Track 


Identifier Summary 

Name Column Type Description 
id Column Imeger 

Property Summary 

Name Column Access Type 
added added field (get / set) Date 
artists field (get / set) Set<Artist> 
comments fiekd (get / set) Set<String> 
filePath fiiePath field (get / set) String 


play Time play Time field (get / set) Date 
sourceMedia sourceMedia field (get / set) SourceMedia 


title TITLE field (get / set) String 
left 

volume 一 一 field (get / set) StereoVolume 
right 


12-5 hbm2doc 生 成 的 Track 实体 文档 


Description 








| All Tables Tables Entities | 
| i #, HIBERNATE 
Schemas 
| default 
——— Schema default 
Table TRACK 
一 
| AIl Tables Column Summary 
| ALBUM Name SqlType Length Precision Scale Nullable Unique 
ALBUM ARTISTS ; . 
——— AEE TRACK ID = imager 255 19 2 fase false 
ALBUM COMMENTS | =S mege 
ALBUM TRACKS TITLE varchan 255) 255 19 2 fase false 
| ARTIST filePath varchan255) 255 19 2 false false 
TRACK | : 
TRACK ARTISTS play Time time 259 19 2 true false 
| TRACK COMMENTS | added date 255 19 2 true false 
| sourceMedia varchan(255) 255: 19 2 true false 
left smalint 255 19 2 false false 
right maliit 255 19 2 fake false 
Primary Key 
Name Columns 
TRACKPK TRACK ID 


图 12-6 hbm2doc 生 成 的 TRACK 数据 库 表 文 档 
[1] http://mojo.codehaus.org/maven-hibenate3/hibernate3-maven-plugin/. 
[2] http://maven.apache.org. 
[3] http://mojo.codehaus.org. 
[4] http://mojo.codehaus.org/maven-hibernate3/hibernate3-maven- 
plugin/componentpropertties. html. 
[5] http://mojo.codehaus.org/maven-hibernate3/hibernate3-maven- 


plugin/components.html. 


超越 Maven 











Maven 一 定 可 以 为 你 节省 不 少时 间 。 我 敢 衣 定 ， 一 定 是 这 样 的 。 如 
末 把 Maven 用 得 恰到好处 ， 你 将 不 必 再 为 维护 一 僚 本 来 已 经 足够 聪明 的 
程序 式 构建 系统 而 花费 精力 (参阅 : 过 度 工 程 (over-engineered) ) 。 
但 是 ， 和 其 他 任何 技术 一 样 ，Maven 自 身 也 存在 一 些 问题 : 它 的 开发 文 
档 仍然 有 些 粗 糙 ， 甚 至 有 些 插件 〈 例 如 Hibernate3 插 件 ) 还 没有 完整 的 
文档 。 


注意 : 如 果 Mojo 提 供 的 Hibernate3 插 件 文 档 不 能 让 你 感到 满意 ， 应 
该 批评 Tim 了 。 他 现在 正和 Mojo 的 维护 人 员 一 起 努力 改进 这 个 插件 。 项 
望 当 你 读 到 这 本 书 时 ，Hibernate3 插 件 已 经 具备 完整 的 文档 了 。 如 果 还 
没有 ， 那 就 随便 给 他 发 个 邮件 催 一 下 吧 。 





问 开 发 团队 中 引入 茶 种 技术 非常 不 容易 ， 无 其 是 那些 对 构建 结构 或 
数据 库 设计 之 类 的 东西 有 特殊 要 求 的 技术 。 我 曾经 见 到 过 有 些 团队 拒绝 
Hibernate， 是 因为 Hibernate 的 合集 映射 不 符合 数据 库 管 理 员 的 标准 。 也 
见 到 过 某 些 组 织 拒绝 Hibernate， 是 因为 它 创 建 的 SQL 达 不 到 开发 团队 认 
可 的 标准 。 对 Hibernate 的 批评 还 有 些 是 非常 抽象 的 ， 听 起 来 好 像 是 什么 
时 竖 的 艺术 评论 家 的 言论 〈“ 关 系数 据 库 是 一 种 过 时 的 结构 ”>) 。 对 于 类 
似 的 这 些 不 理性 的 批评 ，Maven 也 不 是 它们 的 陌生 人 。 无 论 如 何 ， 我 们 





当中 肯定 就 有 这 样 的 人 ， 因 为 可 能 必须 接受 某 种 标准 ， 所 以 就 不 愿意 使 
用 可 以 节省 时 间 的 技术 。 如 果 你 决定 采用 Maven 这 种 构建 工具 ， 那 么 在 
开始 使 用 它 之 前 ， 务 必要 保证 团队 中 的 每 个 人 都 要 接受 这 种 声明 式 
(declarative) 构建 的 思想 。 


在 下 一 章 中 ， 我 打算 介绍 另 一 种 通过 提供 标准 和 约定 来 节省 更 多 时 
间 的 技术 。 你 刚 看 到 Maven 是 如 何 负 员 项 目的 构建 ， 才 让 你 有 时 间 坐 下 
来 放松 一 会 儿 。 第 13 间 将 回 你 演示 如 何 用 Spring Framework 来 完成 
Hibernate 的 大 部 分 编码 工作 。 就 像 Maven 让 项 目 构建 变 得 不 帘 力 气 一 
样 ，Spring 让 使 用 Hibernate 变 得 更 加 容易 。 使 用 这 种 节省 时 间 的 技术 也 
会 有 一 定 的 风险 : 只 需要 花费 片刻 的 延迟 就 完成 了 很 多 索 杂 的 任务 ， 你 
的 老板 可 能 因此 发 现 原 来 你 的 工作 这 么 简单 ， 所 以 就 开始 给 你 分 配 一 堆 
堆 的 任务 。 如 果 你 担心 像 管理 构建 过 程 或 编写 模板 代码 这 样 楷 杂 的 活 都 
做 完 话 ， 我 建议 你 不 必 在 意 本 半 和 下 一 章 介绍 的 内 容 。 男 一 方面 ， 你 可 
以 接受 Maven 和 Spring， 而 用 节省 下 来 的 时 间 多 休 轧 一 会 儿 ， 早 扩 回 
家 ， 或 者 在 Safari 上 阅读 更 多 的 在 线 电子 图 书 也 未 符 不 可 。 

















第 13 章 ”Spring 入 门 : Hibernate 与 Spring 


Spring 是 什么 








如 末 你 关注 一 下 最 近 几 年 Java 编 程 的 发 展 ， 或 许 应 该 听 说 过 Spring 
Framework. Spring Framework 一 个 反 转 控制 (Inversion of Control, 
IoC) 容器 ， 并 集成 了 许多 附加 功能 和 模块 。 在 某 些 方面 ， 它 确实 只 是 
一 个 IoC 容 器 ; 而 在 另 一 些 方面 ， 它 也 是 一 个 完整 的 应 用 程序 开发 平台 

《我 们 将 在 下 一 节 再 具体 介绍 这 些 概 念 的 含义 ) 。 


Spring 最 初 由 Rod Johnson 在 2000 年 创建 ， 现 在 它 已 经 发 展 成 为 有 望 
代替 Enterprise Java Beans (EJB) 的 成 熟 框架 。 在 2000 年 到 2004 年 之 
间 ，Sun Microsystems 发 布 了 一 系列 针对 EJB 的 规范 。 原 来 如 果 不 编写 大 
量 重复 性 代码 ， 并 且 / 或 使 用 专 有 的 工具 来 屏蔽 底层 技术 ， 那 么 将 很 难 
理解 、 开 发 以 及 部 署 EJB。Rod 创 造 性 地 编著 (Expert One-on-One 
J2EE Design and Development) (2002 年 由 WROX 出 版 )， 这 本 书 向 广 
大 开发 人 员 介 绍 了 如 何 用 简单 的 loC 容 器 和 一 系列 封装 API 来 取代 EJB， 
而 这 些 API 可 以 将 你 的 程序 与 Sun 的 底层 API 隔 离开 来 。 在 Spring 中 不 需 
要 直接 与 JDBC、JMS 或 JTA API 直 接 交 互 ， 而 是 应 该 使 用 Spring 提供 的 
各 种 模板 类 和 辅助 类 。 虽 然 Sun 的 核心 企业 API 目 前 仍然 很 重要 ， 但 使 用 
Spring 的 一 个 作用 就 是 放宽 了 Sun 在 定义 或 提议 的 新 库 和 应 用 上 的 限 




















制 。Spring 不 是 直接 对 JDBC 或 JNDI 进 行 编 程 ， 而 是 在 Spring 容器 内 编写 
自己 的 代码 进行 操作 ， 这 样 就 不 必 了 解 实现 持久 化 、 消 息 传递 以 及 其 他 
处 理 时 所 使 用 的 底层 技术 。 作 为 打破 Sun 在 Java 界 定制 标准 的 垄断 地 位 
的 一 种 尝试 ，Spring 并 不 是 现在 惟一 的 项 目 ， 但 它 无 疑 是 最 成 功 的 。 











=> 


尔 可 能 会 写 一 些 自己 的 持久 化 层 对 象 来 直接 与 JDCB 交 互 ， 但 是 也 
可 以 使 用 Oracle 某 种 定制 的 专 有 代码 来 实现 一 部 分 ， 而 用 Hibernate 实 现 
剩余 的 其 他 部 分 。Spring 通 过 提供 一 个 神秘 的 IoC 容 器 和 一 组 有 用 的 抽 
象 ， 就 可 以 支持 这 种 选择 。 有 关 企 业 开发 的 讨论 不 再 只 是 涉及 Sun 和 
Java; Community Process (JCP) 定制 的 各 种 标准 ;相反 ，Spring 通 过 提 
供 一 种 公用 的 “总 线 ”(bus) ， 在 此 基础 上 可 以 构建 大 多 数 新 的 项 目 应 
用 ， 从 而 让 开发 企业 应 用 有 了 更 多 选择 。 以 Spring 与 Web 框 架 的 集成 为 
例 : Wicket, Struts 2〈 原 来 的 WebWork) 、Stripes、GWT 以 及 Tapestry 
都 提供 了 与 Spring 的 优秀 集成 ， 而 String 的 文档 也 详细 介绍 了 与 
JavaServer Faces、Tapestry 以 及 WebWork 的 集成 。Spring 也 为 各 种 对 象 
关系 映射 (Object Relational Mapping) 框架 提供 了 方便 的 集成 ， 包 括 
Hibernate. JDO. Oracle TopLink. iBatis SQL Maps 以 及 JPA。Spring 作 
为 一 个 平台 ， 可 以 让 开发 人 员 “ 自 由 选择 ”各 种 实现 ， 在 一 定 程度 上 来 
说 ， 现 在 几乎 所 有 新 的 开源 库 或 项 目 都 必须 支持 Spring Framework， 才 
能 让 更 多 的 开发 人 员 愿 意 使 用 它 。 业 内 许多 人 士 一 致 认为 ， 虽 然 Sun 可 
能 会 声称 Java 是 一 个 “平台 ”， 但 它 其 实 只 是 一 种 编程 语言 ， 而 Spring 才 


古 一 种 真正 的 平台 。 当 你 读 完 本 章 以 后 ， 就 会 对 Spring 如 何 接管 














Hibernate 的 大 量 工 作 有 所 理解 。 


什么 是 反 转 控制 


对 于 IoC 还 没有 一 个 明确 的 定义 ， 但 比较 集中 的 一 个 就 是 依赖 注入 
(Dependency Injection) 。 在 Wikipedia 上 有 以 下 定义 : 


它 古 指 一 种 模式 ， 其 中 ， 对 象 创建 和 链接 的 控制 由 对 象 转移 到 了 工 


作为 一 种 轻 量 级 容器 ，Spring 负 责 将 一 套 组 件 集成 在 一 起 ， 通 过 
JavaBean 属 性 或 构造 参数 注入 依赖 对 象 的 实例 。 使 用 Spring， 你 可 以 先 
开发 一 系列 简单 的 对 象 ， 再 告诉 Spring 怎么 把 它们 串 接 起 来 以 创建 一 个 
更 大 的 系统 。 如 果 你 的 系统 架构 依赖 的 是 可 重用 的 “组 件 ”， 这 样 的 实现 
方法 就 非常 方便 。 在 本 章 中 ， 我 们 就 用 Spring Application Context 将 数据 
访问 对 象 (Data Access Objects, DAO) 实现 为 这 种 组 件 〈 或 bean) ， 而 
示例 类 则 通过 bean 的 属性 来 依赖 这 些 组 件 。 如 果 想 在 其 他 系统 中 例如 
命令 行 工具 或 Web 应 用 程序 ) 重用 这 些 DAO 类 ， 那 么 系统 可 以 按 bean 属 
性 的 形式 来 依赖 同样 的 组 件 ，Spring 会 以 一 种 描述 程序 结构 的 XML 文档 
为 基础 ， 把 各 种 组 件 都 串 接 起 来 。 








Spring 负责 将 一 套 功能 集中 的 组 件 串 接 在 一 起 ， 通 过 这 种 方法 来 促 
进 组 件 的 重用 。 你 的 DAO 不 必 关 心 它 们 连接 到 什么 组 件 ， 或 是 什么 组 件 


会 使 用 它们 ; 它们 只 是 为 依赖 于 它们 的 组 件 提供 了 一 定 的 接口 。 如 果 你 
对 依赖 注入 或 反 转 控制 的 更 多 细节 感 兴趣 ， 可 以 阅读 一 下 Martin Fowler 
HJ (Inversion of Control Containers》 和 《Dependency Injection Pattern) 


CHJ a 


2H 4 Spring #ll Hibernate 


现在 你 应 该 知道 Spring 是 做 什么 用 的 了 ， 我 们 回头 再 看 看 
Hibernate。 本 章 集 中 介绍 DAO 模 式 、 事 务 抽象 以 及 Spring Framework 提 
供 的 工具 类 。 


你 希望 能 从 本 章 学 到 什么 ? 虽然 通过 Spring 来 使 用 Hibernate 相 当 直 
接 ， 不 过 在 我 们 可 以 真正 利用 Spring 的 Hibernate 集 成 之 前 ， 还 需要 几 步 
准备 工作 。 首 先 ， 因 为 Spring 是 一 个 IoC 容 器 ， 所 以 需要 修改 前 几 章 的 示 
例 ， 以 * 串 接 ” 的 方式 来 创建 对 象 。 我 们 在 下 一 节 才 会 研究 DAO 模 式 。 在 
创建 好 DAO 以 后 ， 将 修改 目前 的 这 套 示例 ， 实 现 一 个 公共 接口 Test， 并 
为 它 应 用 一 个 Transactional 标 注 。 接 着 ， 为 了 创建 Spring 应 用 程序 上 下 
文 ， 我 们 要 编写 一 个 XML 文档 ， 告 诉 Spring 要 创建 什么 对 象 以 及 和 什么 
对 象 串 接 起 来 。 最 后 ， 需 要 写 一 个 命令 行 应 用 程序 ， 用 来 加 载 Spring 应 
用 程序 上 下 文 和 启动 示例 程序 。 











TER: 介绍 足够 了 ， 接 下 来 看 看 代码 吧 。 





添加 Spring 框架 为 项 目 依赖 


为 了 在 示例 项 目 中 使 用 Spring， 需 要 为 构建 过 程 再 添加 一 个 依赖 。 
打开 build.xml， 添 加 例 13-1 中 用 粗 体 突出 显示 的 依赖 。 


例 13-1: 添加 Spring 依赖 











<artifact: dependencies pathId="dependency.class.path"> 
<dependency groupid="hsqldb"artifactId="hsgqldb"version="1.8.0.7"/ 














> 

<dependency 
groupid="org.hibernate"artifactId="hibernate"version="3.2.4.sp1"> 

<exclusion groupId="javax.transaction"artifactId="jta"/> 

</dependency> 

<dependency groupId="o0rg.hibernate"artifactId="hibernate- 
tools"version= 

"3.2.0.beta9a"/> 

<dependency groupId="o0rg.hibernate"artifactId="hibernate- 
annotations" 

version="3.3.0.ga"/> 

<dependency groupId="org.hibernate"artifactId="hibernate-commons- 
annotations" 

version="3.3.0.ga"/> 

<dependency 
groupld="org.apache.geronimo.specs"artifactId="geronimo- 

jta 1.1 spec"version="1.1"/> 

<dependency groupid="log4j"artifactId="log4j"version="1.2.14"/> 

<dependency 
groupiId="org.springframework"artifactId="spring"version="2.5"/> 

</artifact: dependencies> 













































































































































































很 好 ， 现 运行 Ant build， 束 会 看 到 Maven Ant task 将 从 某 个 Maven 仓 
库 中 下 载 spring-2.5.jar。 


[1] http:/ /martinfowler.com/articles/injection.html. 


编写 数据 访问 对 象 


数据 访问 对 象 (Data Access Object, DAO) 是 一 种 常见 的 设计 模 
式 ， 用 于 分 离 应 用 程序 业务 逻辑 代码 和 访问 ， 处 理 数据 库 记 录 的 代码 。 
在 更 大 型 的 体系 结构 中 ，DAO 层 可 以 作为 两 个 独立 的 体系 层次 的 边界 。 
我 们 以 Spring Framework 为 背景 来 介绍 DAO 对 象 ， 以 便 让 你 对 如 何 将 
Hibernate 应 用 到 整体 系统 染 构 中 有 所 了 解 ， 同 时， 之 所 以 要 介绍 DAO 对 
象 ， 也 是 因为 在 现实 世界 需要 与 数据 库 进 行 交互 的 系统 中 ，DAO 对 象 代 
表 了 一 种 常见 的 模式 。 





什么 是 数据 访问 对 象 


如 果 有 作者 用 20 多 页 的 篇 幅 来 介绍 DAO 模 式 、 它 的 优点 和 缺点 ， 不 
免 会 让 我 感到 吃惊 。 如 果 你 看 过 Sun J2EE 蓝 图 ， 它 就 用 很 多 篇 幅 解释 了 
如 何 使 用 工厂 方法 的 DAO 创 建 模式 、 如 何在 更 大 的 方法 中 使 用 DAO 模 
式 以 支持 企业 应 用 程序 的 开发 。 我 们 准备 省 略 很 多 拘泥 于 形式 的 细节 ， 
而 将 DAO 模 式 简 单 地 概括 为 两 点 。DAO 模 式 如 下 : 








将 所 有 持久 化 操作 “创建 、 读 取 、 更 新 、 删 除 〉 归 结 到 一 个 接口 
中 ， 通 常 按 数据 表 或 对 象 类 型 进行 组 织 。 





“该 接口 具有 多 种 可 切换 的 实现 ， 可 以 支持 任意 各 类 的 持久 化 API 和 


底层 存储 介质 。 


或 者 ， 一 个 更 精简 的 定义 是 “DAO 将 持久 化 的 所 有 繁琐 细节 隐藏 在 
接口 之 后 ”。 


当 使 用 像 Hibernate 这 样 的 对 象 /关系 映射 (Object/Relational 
Mapping, ORM) 框架 时 ， 通 常 是 将 数据 库 作 为 一 套 对 象 来 处 理 。 本 书 
的 示例 涉及 3 个 对 象 ， Artist、Album、Track， 与 这 些 对 象 相应 ， 我 们 打 
算 创 建 3 个 DAO 对 象 : ArtistDAO、AlbumDAO、TrackDAO。 图 13-1 简 
单 地 演示 了 要 创建 的 ArtistDAO 的 类 图 。 






cdnterfacen 
ArtistDA0 
Pas) 
persist (Artist artist): Artist 





















- 
+sessionFactory: SessionFactory 








| +-delete( Artist artist): void + getHibernateTemplate(): HibemateTemplate 
+daSomething|}: void | 4uniqueByHametStringname): Artist | +gethession(): Session 
getArtist(String name, boolean create): Artist iy 



















+persest(Artist artist): Artist 
+delete(Artist artist): void 
+uniqueByName(Stringname): Artist 
getArtin{ String name, boolean create): Artist 





图 13-1 用 数据 访问 对 象 来 分 离 应 用 的 业务 逻辑 和 持久 化 代码 


在 这 个 图 中 ， 你 的 应 用 程序 的 业务 逻辑 表示 为 YourClass 类 ， 这 个 
类 有 一 个 对 ArtistDAO 接 口 实例 的 引用 ， 该 接口 定义 了 4 个 简单 的 方法 : 


Artist persist (Artist artist ) 





将 一 个 Artist 对 象 的 状态 保存 到 数据 库 中 。 根 据 artist 参 数 的 状态 ， 
这 个 方法 将 插入 一 个 新 记录 行 ， 或 更 新 一 个 已 有 的 记录 行 。 这 个 方法 的 
约定 是 检查 artist 参 数 的 id 属 性 : 如 果 id 属 性 是 null， 就 同 ARTIST 表 插入 
一 个 新 行 ， 如 果 id 属 性 不 为 null， 就 更 新 数据 库 中 的 相应 行 。 该 方法 返 
回 一 个 持久 化 的 Artist 对 象 ， 换 名 话说， 如果 你 为 这 个 方法 传递 一 个 id 属 
性 为 null 的 Artist 对 象 ， 它 会 在 数据 库 中 创建 一 行 新 的 记录 ， 并 返回 一 个 
id 属性 不 为 null 的 Artist 对 象 ， 这 时 的 id 属性 包含 的 就 是 新 插入 记录 的 标 


识 符 。 


void delete (Artist artist) 


从 数据 库 中 删除 匹配 的 记录 。 


Artist uniqueByName (String name ) 


返回 姓名 等 于 name 参 数值 的 一 个 Artist 对 象 。 


Artist getArtist (String name, boolean create ) 


查找 姓名 匹配 name 参 数值 的 Artist 对 象 。 如 果 create 参 数 为 tue， 则 
当 没 有 找到 匹配 的 Artist 对 象 时 ， 该 方法 就 用 提供 的 name 参 数 来 创建 并 
持久 化 一 个 新 的 Artist 对 象 。 





虽然 在 YourClass 类 的 代码 中 引用 的 是 ArtistDAO 接 口 ， 但 实际 上 调 


用 的 是 ArtistDAO 接 口 的 一 个 实现 一 ArtistHibernateDAO。 该 ArtistDAO 


的 实现 类 继承 了 Spring 的 HibernateDaoSupport 类 ， 这 个 Spring 提供 的 工具 
类 包含 了 所 有 必需 的 魔力 ， 让 Hibernate 代 码 的 编写 变 得 尽 可 能 简单 。 使 
用 HibemateDaoSupport， 你 可 以 不 必 编 写 前 面 几 章 中 看 到 的 所 有 异常 处 
理 、 事 务 管理 以 及 session 管 理 代码 。 事 实 上 ， 我 想 你 一 定 感到 惊讶 (也 
可 能 有 些 失 望 ) ， 在 Spring 中 使 用 Hibernate 变 得 这 么 简单 。 





本 书 使 用 以 下 命名 约定 ，DAO 接 口 在 com.oreilly.hh.dao 包 中 进行 定 
义 ， 它 的 类 名 由 相关 联 的 对 象 名 称 再 附加 上 "DAO" 组 成 〈 例 如 
ArtistDAO) 。 将 该 接口 的 Hibernate 特 定 实现 命名 为 


ArtistHibernateDAO， 放 在 com.oreilly.hh.dao.hibernate 包 中 。 


为 什么 要 使 用 DAO 








之 所 以 要 使 用 DAO 有 很 多 原因 ， 但 第 一 个 也 是 最 重要 的 原因 是 这 种 
模式 可 以 增加 灵活 性 。 因 为 是 对 接口 进行 编码 ， 当 使 用 了 不 同 的 O/R 映 
射 服 务 或 存储 介质 时 ， 就 可 以 方便 地 构建 新 的 实现 。 在 前 面 的 介绍 中 曾 
经 提 过 ，Spring 提 供 的 集成 层 可 以 使 用 许多 对 象 -关系 映射 技术 ， 从 
iBatis SQL Maps 到 Oracle 的 TopLink， 再 到 Hibernate， 但 Spring 也 提供 了 
一 套 丰 语 的 抽象 ， 让 用 JDBC 执 行 SQL 变 得 相当 直接 。 在 我 经 历 过 的 大 
多 数 应 用 程序 开发 中 ，Hibernate 提 供 了 大 部 分 持久 化 逻辑 ， 但 它 并 不 能 
解决 所 有 问题 。 有 时 当 需 要 直接 执行 SQL 时 ， 直 接 使 用 Spring 提供 的 
JDBCTemplate 这 些 类 就 非常 方便 。 如 果 在 应 用 程序 的 业务 逻辑 层 和 持 

















入 层 之 间 插 入 DAO 接 口 ， 这 样 在 需要 的 时 候 ， 就 可 以 更 容易 地 切换 到 其 
他 特定 DAO 类 或 方法 的 实现 。 这 种 灵活 性 和 分 离 性 的 优点 体现 在 两 个 方 
面 ， 其 一 是 可 以 容易 地 替换 特定 DAO 类 的 实现 ， 其 二 是 当 需 要 重 写 或 更 
新 应 用 程序 的 业务 逻辑 时 ， 可 以 重用 己 有 的 持久 化 层 。 本 书 的 许多 读者 
现在 过 到 的 情形 是 : 开发 团队 一 直 在 维护 一 个 用 Struts 1.x 编 写 的 遗留 系 
统 ， 而 你 想 将 应 用 程序 升级 到 Stripes 或 Struts 2。 如 果 持 久 化 代码 紧密 地 
厢 合 到 了 Web 框 架 代 码 中 ， 你 可 能 会 发 现 如 末 不 重 写 其 中 的 一 方面 ， 兢 
不 可 能 重 写 力 一 方面 。 











对 于 这 么 简单 的 一 个 应 用 程序 ， 采 用 DAO 模 式 似乎 显得 没有 必要 
但 是 更 经 常 过 到 的 情况 是 ， 你 需要 在 多 个 项 目 中 重用 持久 化 代码 。DAO 
对 象 看 起 来 似乎 与 敏捷 开发 相 背 离 ， 但 这 种 在 复杂 度 上 的 付出 会 随 着 时 
间 的 推移 而 体现 出 其 价值 。 如 果 你 的 系统 不 是 那 种 简单 的 "Hello 
World" 例 子 ， 残 可 能 需要 花 些 时 间 将 持久 化 逻辑 从 应 用 程序 的 业务 逻辑 
中 分 离 出 来 。 











编写 ArtistDAO 接 口 








不 耽误 时 间 了 ， 我 们 看 看 这 个 示例 的 代码 编写 。 需 要 做 的 第 一 件 事 
就 是 编写 ArtistDAO 接 口 。 在 com.oreilly.hh.dao 包 中 创建 一 个 名 为 
ArtistDAO 的 接口 ， 并 将 例 13-2 所 示 的 代码 放 到 这 个 新 接口 中 。 


例 13-2: ArtistDAO 接 口 





package com.oreilly.hh.dao; 

import com.oreilly.hh.data.Artist; 

/** 

*Provides persistence operations for the Artist object 
*/ 

public interface ArtistDAO{ 

/** 
*Persist an Artist instance (create or update) 
*depending on the value of the id 



























































xy 

public Artist persist (Artist artist) ; 

/** 

*Remove an Artist from the database 

ars 

public void delete (Artist artist) ; 

/** 

*Return an Artist that matches the name argument 
ey 

public Artist uniqueByName (String name) ; 
/** 

*Returns the matching Artist object.If the 




















*create parameter is true, this method will 
*insert a new Artist and return the newly created 
*Artist object. 
xy 

public Artist getArtist (String name, boolean create) ; 


} 


























好 ， 这 段 代 码 看 起 来 相对 比较 容易 ， 这 里 我 们 只 要 介绍 几 个 简单 方 
法 的 实现 。 接 下 来 就 看 看 如 何 使 用 HibernateDaoSupport 类 来 实现 其 处 理 
逻辑 。 


实现 ArtistDAO 接 口 


下 一 步 就 应 该 编写 ArtistDAO 的 实现 。 我 们 打算 编写 一 个 


ArtistHibernateDAO 类 来 实现 ArtistDAO 接 口 ， 并 继承 Spring 的 
HibernateDaoSupport 类 。HibernateDaoSupport 提 供 了 对 Hibernate Session 
对 象 和 HibernateTemplate 的 访问 ， 可 以 用 HibernateTemplate 来 简化 对 
Hibernate Session 对 象 任 意 的 操作 。 为 了 实现 ArtistDAO， 先 在 
com.oreilly.hh.dao.hibernate 包 中 创建 一 个 新 类 ， 让 它 包含 例 13-3 所 示 的 
ArtistDAO 接 口 的 特定 于 Hibernate 的 实现 。 


例 13-3: 实现 ArtistDAO 接 口 





package com.oreilly.hh.dao.hibernate; 

import java.util.HashSet; 

import org.apache.log4j.Logger; 

import org.hibernate.Query; 

import 
org.springframework.orm.hibernate3.support.HibernateDaoSupport; 

import com.oreilly.hh.dao.ArtistDAO; 

import com.oreilly.hh.data.Artist; 

import com.oreilly.hh.data.Track; 

/** 

*Hibernate-specific implementation of the ArtistDAO interface.This 
class 

*extends the Spring-specific HibernateDaoSupport to provide access 
to 

*the SessionFactory and the HibernateTemplate. 

aad 

public class ArtistHibernateDAO extends HibernateDaoSupport 

implements ArtistDAO{ 

private static Logger log= 

Logger.getLogger (ArtistHibernateDAO.class) ; 

/* (non-Javadoc) 

*@see 
com.oreilly.hh.dao.ArtistDAO#persist (com.oreilly.hh.data.Artist) 

ies 

public Artist persist (Artist artist) {@ 

return (Artist) getHibernateTemplate () .merge (artist) ; 

} 

/* (non-Javadoc) 

*@see 



















































































com.oreilly.hh.dao.ArtistDAO#delete (com.oreilly.hh.data.Artist) 
ay 
public void delete (Artist artist) 10 
getHibernateTemplate () .delete (artist) ; 
} 
/* (non-Javadoc) 
*@see 
com.oreilly.hh.dao.ArtistDAO#uniqueByName (java.lang.String) 
ia 
public Artist uniqueByName (final String name) {©@ 
return (Artist) getHibernateTemplate () .execute (new 
HibernateCallback () { 
public Object doInHibernate (Session session) { 
Query 
query=getSession () .getNamedQuery ("com.oreilly.hh.artistByName") ; 
query.setString ("name", name) ; 
return (Artist) query.uniqueResult © ; 
} 
}) ; 
} 
/* (non-Javadoc) 
*@see com.oreilly.hh.dao.ArtistDAO#getArtist (java.lang.String, 
boolean) 
* f 
public Artist getArtist (String name, boolean create) {@ 
Artist found=uniqueByName (name) ; 
if (found==null& &create) { 
found=new Artist (name, new HashSet<Track> (), null) ; 
found=persist (found) ; 

























































































if (found! =null&&found.getActualArtist () ! =null) { 
return found.getActualArtist () ; 

















return found; 





加 这 个 persist ©) 方法 只 是 简单 地 调用 HibernateTemplate 的 
merge O Hik. merge O 方法 的 实现 会 检查 artist 参 数 的 id 属性 。 如 果 
id 为 null, merge O) 方法 就 向 ARTIST 表 插入 一 行 新 的 记录 ， 并 返回 一 人 
和 带 有 生成 的 id 属 性 的 Artist 新 实例 。 如 果 id 属 性 不 为 null, merge O 方法 





就 会 先 碍 找 匹配 的 记录 行 ， 再 用 artist 参 数 的 内 容 来 更 新 这 一 记录 。 


Odelete O 只 是 将 artist 参 数 传递 给 HibernateTemplate 的 delete © 
方法 。 该 方法 需要 接收 一 个 其 id 属性 不 为 null 的 对 象 ， 并 删除 ARTIST 表 
中 的 相应 数据 行 。 





@uniqueByName O 才 是 更 有 趣 的 开始 。 此 处 是 我 们 在 这 个 类 中 
第 一 次 引用 Session 对 象 ， 在 整 本 书 中 曾经 一 直 在 使 用 它 。 首 先 用 
getSession © 获取 一 个 NamedQuery。 接 着 再 设置 命名 参数 name， 取 回 
个 惟一 的 查询 结果 。 如 果 数 据 库 中 没有 匹配 的 Artist uniqueResult O 
将 返回 null。 相 信 你 也 注意 到 这 里 使 用 了 一 个 匿名 的 HibernateCallback 实 
例 ， 并 将 它 传递 给 HibernateTemplate 对 象 。 有 关 HibernateCallback 类 的 
更 多 信息 ， 可 以 参阅 本 章 后 面 的 13.2.6 节 。 











@getArtist〈) 方法 实际 上 只 是 将 查询 转交 给 了 ArtistDAO 中 的 其 他 
方法 。 它 通过 调用 uniqueByName O ， 按 照 名 称 来 取 回 一 个 Artist 对 
象 。 如 果 没 有 找到 任何 Artist 对 象 ， 而 且 create 参 数 为 true, getArtist © 
方法 就 会 创建 一 个 id 属 性 为 null 的 Artist 实 例 ， 再 调用 persist() 方法 。 
如 果 没 有 找到 匹配 的 Artist 对 象 ， 而 且 create 参 数 为 false， 这 个 方法 就 会 
返回 null。 如 果 找 到 的 或 新 创建 的 Artist 对 象 具 有 一 个 非 null 的 actualArtist 
属性 ， 这 个 方法 将 返回 artist.getActualArtist © 的 值 。 (这 一 步骤 的 目 
的 可 以 参阅 第 5.5 节 的 解释 。) 








HibernateDaoSupport 的 功能 


HibernateDaoSupport 可 以 让 我 们 连接 到 SessionFactory， 但 不 必 知 道 
Hibernate 环 境 是 怎么 创建 或 配置 的 。 当 将 HibernateDaoSupport 子 类 化 
(subclass) 到 我 们 的 DAO 类 后 ， 束 可 以 通过 getSession() 方法 访问 
Hibernate Session， 通 过 getHibernateTemplate () 方法 访问 Hibernate- 
Template。 你 应 该 已 经 知道 用 Hibernate Session 对 象 可 以 做 什么 (就 是 本 
书 前 面 10 章 的 内 容 ) 。Spring/Hibernate 集 成 中 有 趣 的 部 分 是 由 
HibernateTemplate 类 提供 的 ， 我 们 接 下 来 就 深入 研究 一 下 这 个 类 的 细 


EAN 


Ta 


根据 HibernateTemplate 的 JavDoc 中 的 说 明 : “可 以 用 这 个 类 来 取代 对 
原始 Hibernate 3 Session API 的 使 用 。”HibermateTemplate 简 化 了 原本 用 
Session 对 象 完成 的 任务 ， 同 时 将 Hibernate-Exception 转 换 为 多 个 通用 的 
DataAccessException。 可 以 用 两 种 方法 来 使 用 HibernateTemplate: 调用 
一 套 简单 的 工具 函数 ， 例 如 load ©) ~ save () 、delete O ; 或 者 使 用 
execute () 方法 来 执行 一 个 HibernateCallback 实 例 的 调用 。 在 大 多 数 情 
况 下 ， 使 用 HibernateTemplate 的 人 简 蛙 工具 函数 就 足够 了 ; 只 有 要 在 
HibernateTemplate 内 执行 某 些 Hibernate 特 定 的 代码 时 ， 才 需要 创建 一 个 


HibernateCallback 对 象 。 





DataAccessException 是 什么 ?在 前 面 介绍 DAO 设 计 模 式 时 ， 就 说 过 
它 的 目的 就 是 要 回应 用 程序 代码 屏蔽 属于 任何 持久 化 API 或 库 的 特殊 





性 。 如 果 我 们 独立 于 特定 技术 的 DAO 抛 出 一 个 Hibernate 特 定 的 
ObjectNotFoundException 异 常 ， 就 对 我 们 没什么 帮助 了 。 所 以 Hibernate- 
Template 就 需要 负责 处 理 可 能 在 其 中 发 生 的 任何 Hibernate 特 定 的 异常 。 
Stripes API 通 过 将 这 些 特定 实现 的 异常 封装 到 它 自己 通用 的 数据 访问 异 
常 中 ， 提 供 了 一 种 对 这 种 异常 进行 包容 的 简单 方法 。 


HibernateTemplate 和 HibernateCallback 是 帮助 我 们 避免 编写 一 行 又 
一 行 不 必要 的 Java 代 人 码 的 实际 骨干 。 接 下 来 就 使 用 它们 两 个 来 重新 实现 
前 面 儿 章 中 的 示例 。 








应 该 怎么 做 


在 使 用 HibernateTemplate 和 HibernateCallback 之 前 ， 我 们 需要 先 大 
致 看 看 它们 提供 的 方法 。HibernateTemplate 提 供 了 很 多 简单 方便 的 方 
法 ， 可 以 将 原来 直接 使 用 Hibernate Session API 时 需要 多 行 代 码 才能 完成 
的 功能 压缩 到 只 需要 简单 的 一 行 。 我 们 以 查询 数据 库 表 为 例 ， 来 看 看 这 
种 简单 方法 到 底 是 怎么 回 事 。 例 13-4 演 示 了 查询 和 搜索 对 象 的 几 个 示 
例 。 











例 13-4: HibernateTemplate 的 find O 工具 方法 








HibernateTemplate tmpl=getHibernateTemplate () ; 

//All of these lines Find Artist with name'Pavement' 

List artists=tmpl.find ("from com.oreilly.hh.data.Artist a"+ 
"where a.name='Pavement'") ; Q 























String name="Pavement"; 

List artists=tmpl.find ("from com.oreilly.hh.data.Artist a™+ 

"where a.name=?", name); @ 

List artists=tmpl.findByNamedParam ("from 
com.oreilly.hh.data.Artist a"+ 

"where a.name=: name", "name", name) ; ® 

//Assuming that there is a NamedQuery annotation"Artist.byName"on 
the 

//Artist class 

List artists=tmpl.findByNamedQuery ("Artist.byName", name); @ 

Artist Artist=new Artist () ; 

artist.setName ("Pavement") ; 

List artists=tmpl.findByExample (artist); 加 

//I£ we want to iterate through the result 
Iterator artists=tmpl.iterate ("from com.oreilly.hh.data.Artist"+ 
"where a.name=?", name) ; O 
//The following lines find all Artists 
List artists=tmpl.find ("from com.oreilly.hh.data.Artist") ; @ 
List artists=tmpl.loadAll (Artist.class) ; 
















































































































































































Find 方 法 相对 比较 直接 : 


各 这 是 一 个 简单 的 find《〈) 方法 ， 接 受 一 个 不 带 参 数 的 HQL 查 询 语 
Jo 


全 该 方法 的 这 个 版 本 接受 一 个 HQL 查 询 语句 ， 以 及 一 个 附加 的 参 
数 。 类 似 地 另 一 个 版 本 将 接受 一 个 查询 语句 和 一 组 附加 的 参数 :List 
find (String hql, Object[Jparams) 。 这 些 方法 都 支持 非 命 名 查询 参数 的 
使 用 ， 但 正如 第 3 章 所 述 ， 编 写 查询 还 有 更 好 的 方法 。 








@findByNamedParameter O 方法 可 以 处 理 带 有 命名 参数 的 查询 。 


@findByNamedQuery ©) 方法 可 以 让 你 快速 调用 一 个 预定 义 的 
HQL 碍 询 ， 在 这 个 例子 中 是 名 为 "ArtistbyName" 的 查询 。 


全 通过 findByExample O 方法 ， 还 可 以 使 用 Hibernate 的 示例 查询 


(query-by-example) 的 功能 。 


@ 如 果 想 循环 遍历 查询 结果 ， 可 以 调用 iterate O 方法 。 当 调用 
iterate O 方法 时 ，Hibernate 首 先 取 回 匹 配 数据 行 的 所 有 ID， 当 通过 返 
回 的 Iterator 通 历 结 果 时 ， 再 初始 化 各 个 元 素 。 





@ 最 后 ， 如 果 只 是 想 加 载 给 定 某 个 表 的 所 有 数据 行 ， 则 可 以 调用 
find © 或 loadAll () 方法 。 


正如 第 3.4 节 所 讨论 的 ， 命 名 奉 询 是 一 种 将 查询 定义 移出 DAO 代 码 
的 好 办 法 。 如 果 你 使 用 的 是 标注 ， 可 以 使 用 @NamedQuery 标 注 来 定义 
命名 奋 询 。 有 关 该 标注 的 更 多 细节 可 以 参阅 第 7 章 的 相关 内 容 。 





如 果 我 们 已 经 知道 了 某 个 持久 对 象 的 人 D 值 ， 就 可 以 用 
HibernateTemplate 提 供 的 工具 方法 通过 ID 来 加 载 对 象 ， 如 例 13-5 所 示 。 


例 13-5: 用 HibernateTemplate 加 载 对 象 

















//Identifier of Artist to load 

Integer id=1; 

//Load an Artist object, return persistent Artist object 
Artist artist=getHibernateTemplate () .load (Artist.class, id) ; 
//Populate the object passed in as a parameter.Using the 
//object's type to specify the class 

Artist artist=new Artist () ; 

getHibernateTemplate () .load (artist, id); 
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在 第 1 个 例子 中 ， 我 们 用 一 个 Class 和 序列 化 ID 值 来 调用 load O K 
数 。Hibernate 将 从 数据 库 中 检索 对 应 的 记录 ， 并 返回 请 求 对 象 的 实例 。 
除了 使 用 Class 对 象 ， 你 也 可 以 传递 一 个 对 象 实例 ，Hibernate 会 用 参数 的 
类 型 来 决定 检索 哪个 类 。 








我 们 已 经 看 过 了 HibernateTemplate 中 用 于 查询 和 加 载 对 象 的 工具 方 
法 。 那 么 怎样 修改 数据 库 中 的 记录 呢 ? 例 13-6 演 示 了 几 个 在 数据 库 中 插 
入 和 更 新 记录 的 示例 。 








例 13-6: 用 HibernateTemplate 保 存 和 更 新 记录 





//Persist a new instance in the database 

Artist a=new Artist () ; 

a.setName ("Fischerspooner") ; 

getHibernateTemplate () .save (a) ; 

//Load, modify, update a row in the database 

Artist a=getHibernateTemplate () .load (Artist.class, 1) ; 
a.setName ("Milli Vanilli") ; 

getHibernateTemplate () .update (a) ; 

//Bither insert or update depending on the identifier 
//of the object; associate resulting object with Session 
Artist a=getHibernateTemplate () .merge (a) ; 






























































Save () Allupdate O 方法 也 比较 直观 ， 这 两 个 方法 与 Hibernate 
Session 对 象 上 的 同名 方法 类 似 。Save〈) 方法 生成 一 个 新 的 ID， 并 向 数 
据 表 中 插入 一 行 新 的 记录 ; update O 方法 则 更 新 数据 库 表 中 的 匹配 记 
Ko merge () 方法 更 灵活 些 : 它 会 检查 参数 的 id 属性 ， 按 照 IDP 是 否 大 
null 来 调用 save《〈) Bkupdate O 方法 。 


也 可 以 通过 HibernateCallback， 使 用 Hibernate Session 来 执行 任何 
SQL 语句 。 在 详细 解释 这 一 用 法 之 前 ， 我 们 先 看 看 例 13-7。 


例 13-7: 编写 HibernateCallback 








final String name="Pavement"; 

Artist artist= (Artist) getHibernateTemplate () .execute (new 
HibernateCallback () { 

public Object doInHibernate (Session session) { 

Criteria criteria=session.createCriteria (Artist.class) ; 

criteria.add (Restrictions.like ("name", name) ) ; 

return criteria.uniqueResult () ; 

} 

}) ; 



































那么 这 个 例子 中 到 底 发 生 了 什么 ? 这 个 示例 首先 实例 化 一 个 实现 了 
HibernateCallback 接 口 的 匿名 内 部 类 ， 并 将 它 传递 给 HibernateTemplate 
的 execute () 方法 。HibernateCallback 接 口上 只 定义 了 一 个 方法 
doInHibernate © ， 需 要 向 它 传递 一 个 Hibernate Session。 在 这 个 方法 的 
内 部 《在 我 们 的 匿名 内 部 类 中 实现 的 ) 使 用 Hibernate Criteria API 生 成 碍 
询 ， 按 姓名 检索 回 一 个 Artist 对 象 。 








为 什么 当 我 们 本 来 能 够 容易 地 获得 Hibernate Session 的 引用 ， 而 且 
也 能 创建 同样 的 Criteria 对 象 时 ， 却 要 使 用 回调 方法 ? 即使 在 
HibernateDaoSupport 中 使 用 getSession O 方法 能 够 直接 访问 Session 对 
象 ， 我 们 还 是 希望 避免 直接 调用 Hibernate API， 因 为 我 们 不 想 抛 出 任何 


Hibernate 特 定 的 异常 〈 甚 至 也 不 想 抛 出 RuntimeException ) 。 需 要 记 





住 ， 你 的 应 用 程序 正在 通过 一 个 接口 来 访问 这 个 DAO， 它 不 知道 也 不 关 
心 Hibernate 特 定 的 ObjectNotFoundException 或 HQL 中 的 异常 。 不 是 直接 
FAgetSession () 访问 Session 对 象 ， 你 能 够 也 应 该 回 你 的 应 用 程序 屏 菩 
这 些 底 层 处 理 细节 ， 这 就 是 为 什么 要 在 HibernateTemplate 中 用 
HibernateCallback 来 运行 Hibernate API 调 用 的 原因 了 。 


其 他 DAO 在 哪里 


因为 这 些 DAO 处 理 都 非常 相似 ， 所 以 不 值得 在 这 里 一 一 列 出 和 讨论 
其 他 DAO 处 理 了 。 你 可 能 不 想 手 工 输 入 所 有 代码 ， 如 果 还 想 看 看 它们 的 
话 ， 只 要 下 载 代 码 示例 就 可 以 了 。 





创建 应 用 程序 上 下 文 对 象 


前 面 介 绍 Spring 时 ， 我 们 讨论 了 它 如 何 负责 创建 和 连接 应 用 程序 中 
的 组 件 。 为 了 让 Spring 组 装 各 组 件 ， 我 们 需要 告诉 它 系 统 中 有 什么 组 件 
(Spring 将 它们 称 为 bean) 以 及 它们 之 间 是 如 何 连接 在 一 起 的 。 我 们 使 
用 一 个 XML 文档 来 描述 每 个 bean 的 类 ， 为 每 个 bean 分 配 一 个 ID， 建 立 起 
各 个 bean 之 间 的 关联 关系 。 为 什么 要 用 ID? 在 Spring 中 ，ID 就 是 每 个 
bean 的 惟一 的 逻辑 名 称 ， 在 表达 bean 之 间 的 关系 ， 以 及 在 运行 时 请 求 
bean 时 ， 就 会 用 到 bean 的 ID 属性 。 在 我 们 的 示例 Spring 配置 文件 中 ， 就 
使 用 了 诸如 artistDao 和 albumDao 之 类 的 逻辑 名 称 ， 每 个 ID 引用 了 在 配置 
文件 中 定义 的 一 个 组 件 。 


Spring 再 用 这 个 XML 文档 来 创建 一 个 ApplicationContext 对 象 ， 利 用 
这 个 对 象 我 们 就 可 以 按 名 称 取 回 相 应 的 组 件 。 图 13-2 是 我 们 这 个 程序 


ApplicationContext 的 内 容 结 构图 表 。 





图 13-2 我 们 的 Spring 应 用 程序 上 下 文 


从 图 13-2 中 可 以 看 到 ， 我 们 的 3 个 测试 组 件 与 3 个 DAO 对 象 连接 在 一 
起 ， 每 个 DAO 对 象 都 有 一 个 会 话 工厂 对 象 引 用 ， 它 负责 创建 一 个 
Hibernate 会 话 对 象 和 连接 到 数据 库 。 这 个 应 用 程序 的 Spring 配 置 文件 如 
例 13-8 所 示 ， 应 该 将 它 命名 为 applicationContext.xml， 并 放 在 src 目 录 





例 13-8: Spring 的 配置 文件 applicationContext.xml 





<?xml version="1.0"encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmins: xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmins: tx="http://www.springframework.org/schema/tx" 

xsi: schemaLocation= 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-2.0.xsd 
http: //www.springframework.org/schema/tx 
http://www.springframework.org/schema/tx/spring-tx-2.0.xsd" 
default-lazy-init="true">@ 

<bean id="sessionFactory"@ 
class="org.springframework.orm.hibernate3.annotation.Annotation 
SessionFactoryBean"> 
<property name="annotatedClasses">®@ 
<list> 











































































































<value>com.oreilly.hh.data.Album</value> 
<value>com.oreilly.hh.data.AlbumTrack</value> 
<value>com.oreilly.hh.data.Artist</value> 
<value>com.oreilly.hh.data.StereoVolume</value> 
<value>com.oreilly.hh.data.Track</value> 
</list> 

</property> 

<property name="hibernateProperties">@ 

<props> 

<prop key="hibernate.show sql">false</prop> 
<prop key="hibernate.format_sql">true</prop> 
<prop key="hibernate.transaction.factory class">org.hibernate. 























transaction. JDBCTransactionFactory</prop> 


<prop key="hibernate.dialect">org.hibernate.dialect.HSQLDialect 
</ prop 
<prop key="hibern 
<prop key="hibern 
.jdbcDriver</prop> 








.connection.pool size">0</prop> 
sconneéction. driver class" ->org.hsqldb 





al 
al 


CT CT 
































<prop key="hibernate.connection.url">jdbc: hsqldb: data/music; 
shutdown=true</prop> 

<prop key="hibernate.connection.username">sa</prop> 

<prop key="hibernate.connection.password" ></prop> 

</props> 

</property> 

</bean> 

<! --enable the configuration of transactional behavior based on 











annotations--> 
<tx: annotation-driven transaction-manager="transactionManager"/> 





© 

<bean id="transactionManager" 

class="org.springframework.orm.hibernate3.HibernateTransactionMana 

<property name="sessionFactory"> 

<ref local="sessionFactory"/> 

</property> 

</bean> 

<bean 
class="org.springframework.beans.factory.annotation.RequiredAnnotatior 
BeanPostProcessor"/>@ 



































<! --Define our Data Access beans--> 

<bean 
id="albumDAO"class="com.oreilly.hh.dao.hibernate.AlbumHibernateDAO" > 
@ 

<property name="sessionFactory"ref="sessionFactory"/> 

</bean> 

<bean 
id="artistDAO"class="com.oreilly.hh.dao.hibernate.ArtistHibernateDAO": 

<property name="sessionFactory"ref="sessionFactory"/> 

</bean> 

<bean 
id="trackDAO"class="com.oreilly.hh.dao.hibernate.TrackHibernateDAO" > 

<property name="sessionFactory"ref="sessionFactory"/> 

</bean> 

<! --Define our Test beans--> 


<bean id="createTest"class="com.oreilly.hh.CreateTest">@ 
<property name="trackDAO"ref="trackDAO"/> 

<property name="artistDAO"ref="artistDAO"/> 

</bean> 
<bean id="queryTest"class="com.oreilly.hh.QueryTest"> 
<property name="trackDAO"ref="trackDAO"/> 
</bean> 
<bean id="albumTest"class="com.oreilly.hh.AlbumTest"> 









































<property name="albumDAO"ref="albumDAO"/ > 
<property name="artistDAO"ref="artistDAO"/> 
<property name="trackDAO"ref="trackDAO"/> 
</bean> 

</beans> 

















虽 ， 要 读 的 XML 代码 量 还 不 小 ， 不 是 吗 ? 其 实在 这 个 文件 中 还 有 
很 多 有 趣 的 东西 ， 接 下 来 就 细 细 梳理 一 下 这 个 文件 中 的 每 个 部 分 : 











加 顶级 元 素 是 <beans 之 ， 为 了 让 Spring 能 够 正常 运行 ， 我 们 必须 为 
其 声明 一 些 重 要 的 命名 空间 。 
http://www.springframework.org/schema/beans 命 名 空间 是 用 于 描述 声明 的 
bean 元 素 的 默认 命名 空间 ， 而 http://www.springframework.org/schema/tx 
命名 空间 则 用 于 定义 标注 驱动 的 事务 配置 ， 本 章 稍 后 会 介绍 这 一 内 容 。 
<default-lazy-init > JR PET H] Spring IoC 容 器 的 默认 行为 。 如 果 该 默认 设 
置 为 tue， 则 只 有 当 请 求 组 件 时 ，Spring 才 会 实例 化 这 些 组 件 。 如 果 把 
default-lazy-init 设 置 为 false， 则 Spring 在 ApplicationContext 初 始 化 期 间 就 
实例 化 相关 的 bean。 





人 @ 会 话 工厂 这 个 bean 负 责 生成 会 话 对 象 ， 处 理 到 JDBC DataSource 
的 连接 。 通 常 ， 会 话 工 厂 将 使 用 一 个 DataSource， 我 们 在 
applicationContext.xml 中 可 以 为 会 话 工厂 配置 一 个 Commons DBCP 或 
C3P0 连 接 。 为 了 保持 这 个 例子 的 完整 性 ， 会 话 工厂 的 配置 直接 包含 了 
用 于 配置 JDBC 连 接 的 各 属性 。 





全 和 在 hibernate.cfg.xml 文 件 中 进行 配置 一 样 ， 此 处 是 在 定义 需要 


Hibernate 处 理 的 标注 类 。 


@hibemateProperties 元 素 用 于 配置 Hibernate 的 设置 。 稍 后 在 本 章 的 
13.3.1 节 再 深入 介绍 这 一 配置 的 细节 。 


加 事务 管理 相关 的 标注 配置 稍 后 在 本 章 的 13.4.1 节 再 深入 介绍 
tx: annotation-driven 元 素 和 transactionManager 定 义 可 以 让 我 们 使 用 
Transactional 标 注 来 定义 应 用 程序 中 任何 事务 的 范围 和 属性 。 


QRequiredAnnotationBeanPostProcessor 是 一 个 没有 命名 的 组 件 ， 有 
了 这 个 组 件 ， 就 可 以 为 带 有 Required 标 的 setter 方 法 激活 一 些 强 制 处 理 。 
如 果 将 这 个 Required 标 注 属 性 放 在 必需 的 bean 属 性 的 setter 方 法 上 ， 
Spring 就 会 在 初始 化 一 个 bean 后 ， 再 验证 这 个 属性 是 否 被 设置 。 在 测试 
类 中 可 以 用 这 种 方法 来 确保 Spring 已 经 配置 好 了 我 们 的 DAO 依 赖 。 








@ 在 这 里 定义 好 了 DAO 对 象 : albumDAO、artistDAO 以 及 
trackDAO. 








全 在 这 里 定义 好 了 test bean: createTest. queryTest L4 XalbumTest. 
Hibernate 配 置 属性 


仔细 看 看 例 13-8 中 的 hibernateProperties 部 分 ， 其 中 有 许多 有 趣 的 配 
置 属性 ， 分 别 解 释 如 下 : 


hibernate.connection.driver_class. hibernate.connection.url, 


hibernate.connection.username. hibernate.connection.password 





这 几 个 配置 属性 负责 配置 数据 库 的 JDBC 连 接 。 这 些 属 性 与 前 面 几 
章 中 的 配置 属性 类 似 ， 它 们 在 applicationContext.xml 中 的 属性 值 与 早先 
在 hibernate.cfg.xml 和 hibernate.properties 中 的 取 值 完全 一 样 。 


hibernate.connection.pool_size 


这 个 属性 用 于 设置 Hibernate 内 部 连接 池 (connection pool) 容量 的 
大 小 。 如 果 不 使 用 Hibernate 提 供 的 连接 池 ， 也 可 以 使 用 Hibernate 内 建 的 
支持 Apache Commons DBCP 或 C3P0， 对 于 产品 级 系统 的 部 署 ， 这 两 种 
连接 池 都 是 很 好 的 选择 。 如 果 将 这 个 属性 值 设 置 成 一 个 非 零 的 数值 ， 
Hibernate 就 会 负责 回收 和 重用 数据 库 的 连接 。 





这 种 情况 很 有 趣 ， 因 为 我 想 为 这 个 示例 关 掉 连接 池 ， 以 简化 
HSQLDB 的 使 用 ， 所 以 将 pool_size 设 置 为 0。 当 最 后 一 个 数据 库 连 接 终 
止 时 ，HSQLDB 需 要 接收 一 个 SHUTDOWN 命 令 ， 因 为 在 这 里 我 不 想 再 
编写 和 配置 一 个 专门 的 关闭 脚本 ， 而 是 简单 地 保证 在 用 完 JDBC 
Connection 对 象 后 就 马上 关闭 它 。 


hibernate.dialect 


这 个 属性 用 于 设置 Hibernate 方 言 (dialect) 。 现 在 Hibernate 支 持 的 








所 有 方言 列表 ， 请 参阅 附录 C。 
hibernate.transaction.factory_class 


在 这 个 示例 中 ， 我 们 使 用 JDBC 了 驱动 程序 来 管理 数据 库 事 务 。 更 复 
杂 的 部 闭环 境 需要 使 用 JTA， 如 果 我 们 使 用 容 霹 托管 的 事务 ， 则 可 以 将 


该 属性 配置 为 org.hibernate.transaction.JTATransactionFactory。 
hibernate.show_sql、hibernate.format_sql 


如 果 将 show_sql 设 置 为 tue, Hibernate 将 打印 输出 它 正 在 执行 的 SQL 
语句 。 如 果 你 在 调试 Spring， 想 弄 清 楚 某 个 映射 是 怎么 访问 数据 库 表 
的 ， 这 个 配置 属性 就 很 有 用 。 如 果 将 format_sql 设 置 为 tue， 就 会 格式 化 
输出 的 SQL 语 句 ， 如 果 将 format_sql 设 置 为 false, SQL 语句 只 打印 输出 到 


/一 


=e 


把 所 有 组 件 装 配 在 一 起 


如 果 我 们 不 知道 如 何 创建 一 个 Spring ApplicationContext 和 运行 我 们 
的 代码 ， 所 有 这 些 Spring 配 置 也 就 没什么 用 途 。 在 本 节 ， 我 们 打算 调整 
前 面 的 示例 CreateTest、QueryTest、AlbumTest 类 ， 实 现 一 个 Test 接 口 ， 
不 是 直接 从 命令 行 运行 它们 ， 而 是 创建 一 个 TestRunner 来 执行 这 些 从 


Spring ApplicationContext 获 取 的 测试 对 象 。 


Transactions: 测试 接口 





本 章 稍 后 会 编写 一 个 名 为 TestRunner 的 类 ， 这 个 类 会 知道 怎么 从 
Spring ApplicationContext 中 取 回 一 个 bean， 这 个 bean 应 该 实现 Test 接 
口 ， 需 要 调用 执行 该 bean 的 rn ©) 方法 。TestRunner 使 用 的 bean 源 于 对 
前 面 几 章 的 CreateTest、QueryTest 以 及 AlbumTest 的 修改 调整 。 为 了 文 持 
这 种 新 的 运行 方式 ， 我 们 让 它们 分 别 实现 一 个 公共 的 Test 接 口 ， 如 例 13- 
9 所 示 。 


例 13-9: Test 接 口 





package com.oreilly.hh; 
import org.springframework.transaction.annotation. Transactional; 
/** 

*A common interface for our example classes.We'll need this 
*because TestHarness needs to cast CreateTest, QueryTest, or 
*AlbumTest to a common interface after it retrieves the bean 
*from the Spring application context. 





















































ay 





public interface Test f{ 
/** 

*Runs a simple example 
=f 





@Transactional (readOnly=false) 
public void run () ; 


} 





这 个 Test 接 口 用 于 为 TestRunner 提 供 一 个 公共 接口 ， 它 也 为 我 们 这 
加 Transactional 标 注 提 供 了 一 种 方便 的 方法 。Transactional 标 注 负 责 将 一 
个 Session 对 象 绑 定 到 当前 线程 ， 司 动 一 个 事务 处 理 ， 如 果 方 法 正 冲 返 
E, MEXES, WRAKI, MERES. 





有 关 @Transactional 标 注 的 更 多 信息 ， 请 参阅 附录 DD。 


如 何 激活 事务 标注 


为 了 打开 Transactional 标 注 的 处 理 ， 需 要 在 我 们 的 
applicationContext.xml 文 件 中 添加 以 下 一 段 配置 信息 : 











<! --enable the configuration of transactional behavior based on 
annotations--> 

<tx: annotation-driven transaction-manager="transactionManager"/> 

<bean id="transactionManager" 

class="org.springframework.orm.hibernate3.HibernateTransactionMana 

<property name="sessionFactory"> 

<ref local="sessionFactory"/> 

</property> 

</bean> 

















tx: annotation-driven 元 素 简 单 地 激活 了 Transactional 标 注 ， 将 它 指 


向 一 个 PlatformTransaction-Manager。HibernateTransactionManager 是 
Spring Framework 的 PlatformTransactionManager 接 口 的 一 个 实现 。 它 负 
责 将 来 自 会 话 工厂 的 一 个 Hibernate Session 对 象 用 会 话 工厂 Utils 绑 定 到 当 
前 线程 〈Thread) 。 因 为 我 们 的 DAO 对 象 都 继承 自 
HibernateDaoSupport， 也 都 使 用 HibernateTemplate， 所 以 这 些 持久 化 对 
象 就 能 够 参与 到 事务 管理 当中 ， 并 获得 相同 线程 上 的 会 话 对 象 。 这 不 仅 
仅 是 因为 事务 处 理 的 需要 ， 在 使 用 延迟 加 载 的 关联 时 ， 它 也 是 必需 的 。 
Transactional 标 注 可 以 确保 在 执行 标注 过 的 方法 时 ， 让 同一 会 话 对 象 保 
持 打 开 ， 并 绑 定 到 当前 线程 。 如 果 没 有 这 个 标注 ，Hibernate 就 会 为 每 个 
需要 会 话 的 操作 都 创建 一 个 新 的 会 话 对 象 ， 你 也 就 不 能 取 回 原来 用 
Hibernate 检 索 到 的 对 象 上 的 任何 关联 。 











为 什么 会 这 样 ? 让 我 们 回顾 一 下 第 5 章 介绍 过 的 主题 。 在 Hibernate 3 
中 ， 了 映射 对 象 之 间 的 关联 默认 都 使 用 延迟 加 载 。 除 非 为 某 个 类 或 关联 显 
式 地 改变 这 种 默认 加 载 方式 ， 直 到 你 访问 某 个 特定 对 象 时 ， 才 真正 从 数 
据 库 中 检索 相关 联 的 对 象 。 例 如 ， 如 果 从 数据 库 中 检索 回 一 个 Album 对 
象 ， 直 到 你 调用 album.getAlbumTracks O 方法 时 ， 才 会 从 数据 库 中 再 
检索 回 AlbumTrack 的 List 列 表 对 象 。 为 此 ，Hibernate 要 做 两 件 事 : 








1.Hibernate 返 回 一 个 “代理 ”对 象 ， 用 于 代表 还 没有 加 载 的 对 象 。 当 
检索 Track 对 象 时 ， 返 回 的 对 象 是 一 个 Track， 不 过 相关 联 的 集合 (例如 


track.getArtists () ) 则 是 PersistentSet 的 一 个 实例 。 


2.PersistentSet 由 Hibernate 负 责 管理 ， 你 通常 不 需要 考虑 这 一 对 象 。 
与 这 里 的 讨论 相关 的 是 ， 它 是 PersistentCollection 的 一 个 实现 ， 包 含 了 对 
会 话 对 象 的 一 个 引用 。 换 名 话说 ， 在 按照 需要 而 获取 相关 联 的 Artists 
时 ， 涉 及 的 是 PersistentSet。 你 可 以 取 回 一 个 Track 对 象 ， 但 是 在 调用 
track.getArtists ©) 之 前 ， 并 不 会 取 回 任何 Artist 对 象 ， 而 且 即 便 取 回 关 
联 的 Artist 对 象 ， 也 得 再 次 通过 会 话 对 象 。 





只 有 当 PersistentSet 引 用 了 一 个 活动 的 会 话 对 象 时 ， 延 迟 加 载 关 联 才 
有 效果 。 如 果 没 有 一 个 打开 的 会 话 ， 这 时 再 试图 访问 延迟 加 载 的 关联 
时 ， 就 会 抛 出 一 个 异常 。 在 Web 应 用 程序 中 ， 可 以 使 用 Spring 的 
OpenSessionInViewFilter 之 类 的 东西 来 确保 在 一 个 请 求 中 持 有 对 一 个 会 
话 对 象 的 引用 。 在 这 个 应 用 程序 中 ， 我 们 依靠 Transactional 标 注 来 确保 
run O 方法 实现 的 所 有 代码 都 可 以 访问 到 同一 个 Hibernate 会 话 对 象 。 








调整 CreateTest、QueryTest 以 及 AlbumTest 


现在 我 们 已 经 定义 好 了 Test 接 口 ， 而 且 为 这 个 接口 的 实现 还 建立 了 
一 个 稳定 的 事务 管理 环境 。 接 下 来 就 可 以 修订 我 们 原来 的 CreateTest、 
QueryTest 以 及 AlbumTest 类 。 首 先 按 例 13-10 所 示 来 修改 CreateTest 类 。 


例 13-10: 为 了 在 Spring 中 使 用 而 修改 CreateTest 关 





package com.oreilly.hh; 
import java.sgl.Time; 





























import java.util.*; 

import com.oreilly.hh.dao.*; 

import com.oreilly.hh.data.*; 

/** 

*Create sample data, letting Hibernate persist it for us. 


ay 
public class CreateTest implements Test{ 
private ArtistDAO artistDAO; 
private TrackDAO trackDAO; 
/** 
*Utility method to associate an artist with a track 
mi 
private static void addTrackArtist (Track track, Artist artist) { 
track.getArtists () .add (artist) ; 
} 
/* (non-Javadoc) 
*@see com.oreilly.hh.Test#run () 
ey 
public void run () { 
StereoVolume fullVolume=new StereoVolume () ; 
Track track=new Track ("Russian 
Trance", "vol2/album610/track02.mp3"; 
Time.valueOf ("00: 03: 30") , new HashSet<Artist> () , new 
Date () , 
fullVolume, SourceMedia.CD, new HashSet<String> O ) ; 
addTrackArtist (track, artistDAO.getArtist ("PPK", true) ) ; 
trackDAO.persist (track) ; 
} 
public ArtistDAO getArtistDAO () {return artistDAO; } 
public void setArtistDAO (ArtistDAO artistDAO) { 
this.artistDAO=artistDAO; 
} 
public TrackDAO getTrackDAO () {return trackDAO; } 
public void setTrackDAO (TrackDAO trackDAO) { 
this.trackDAO=trackDAO; 
} 
} 







































































注意 CreateTest 类 有 两 个 私有 的 成 员 变 量 : artistDAO 和 trackDAO， 
它们 都 配备 了 作为 bean 属 性 的 访问 器 Caccessor) 方法 。 接 着 ， 按 照 Test 
接口 的 规定 ， 我 们 实现 了 一 个 简单 的 mn() 方法 ， 它 最 终 会 调用 
trackDAO.makePersistent O 来 完成 Track 对 象 的 持久 化 。 所 有 的 处 理 就 


是 这 样 的 ， 没 有 try/catch/finally 块 ， 也 没有 涉及 事务 管理 。 在 DAO 类 的 

帮助 下 ， 我 们 差不多 将 所 有 持久 化 处 理 都 交 给 了 Spring 框 架 。 例 13-11 是 
从 applicationContext.xml 摘 取 的 一 段 代 码 ， 该 配置 将 CreateTest 类 创建 成 
一 个 ID 为 createTest 的 bean， 并 将 它 的 artistDAO 和 trackDAO 属 性 组 装 为 

相应 DAO bean 的 引用 。 








例 13-11: 配置 CreateTest bean 





<bean id="createTest"class="com.oreilly.hh.CreateTest"> 
<property name="trackDAO"ref="trackDAO"/> 

<property name="artistDAO"ref="artistDAO"/> 

</bean> 














将 CreateTest 的 这 个 实现 与 例 3-3 的 原始 版 本 进行 比较 ， 你 会 发 现 它 
现在 已 经 面目 全 非 了 。 非 Spring 版 本 的 CreateTest 类 必须 负责 维护 会 话 对 
象 的 创建 、 事 务 管理 、 异 常 处 理 以 及 配置 。 而 最 新 的 版 本 甚至 连 会 话 的 
影子 也 没有 看 到 。 事 实 上 ， 在 CreateTest 的 最 新 版 本 中 没有 一 点 
Hibernate 特 定 的 东西 : DAO 类 让 我 们 的 应 用 程序 的 业务 逻辑 不 必 直 接 处 
理 底 层 的 持久 化 机 制 。 换 句 话说， 在 你 熟悉 了 Spring Framework, 228 
好 它 以 后 ， 通 过 Spring 进行 持久 化 要 比 直接 使 用 Hibernate 容 易 很 多 。 再 
看 看 例 13-12。 





例 13-12: 为 了 在 Spring 中 使 用 而 修改 QueryTest 类 





package com.oreilly.hh; 
import java.sgl.Time; 

















import java.util.List; 

import org.apache.log4j.Logger; 
import com.oreilly.hh.dao.TrackDAO; 
import com.oreilly.hh.data.Track; 
/** 

*Retrieve data as objects 

4 


public class QueryTest implements Test{ 

private static Logger log=Logger.getLogger (QueryTest.class) ; 
private TrackDAO trackDAO; 

public void run () { 

//Print the tracks that will fit in five minutes 
List<Track>tracks=trackDAO.tracksNoLongerThan (人 
Time.valueOf ("00: 05: 00") ) ; 

for (Track track: tracks) { 

//For each track returned, print out the 

//title and the playTime 

log.info ("Track: \""+track.getTitle () +"\", " 
+track.getPlayTime () ) ; 

} 

} 

public TrackDAO getTrackDAO () {return trackDAO; } 
public void setTrackDAO (TrackDAO trackDAO) { 
this.trackDAO=trackDAO; 

} 

} 


















































重新 实现 的 QueryTest 也 定义 了 一 个 私有 成 员 变 量 ， 用 于 引用 


TrackDAO 对 象 。run ©) 方法 调用 trackDAO.tracksNoLongerThan () 77 
法 ， 并 为 它 传递 了 一 个 表示 5 分 钟 的 Java.sql.Time 类 型 的 变量 。 这 段 代码 
循环 访问 碍 询 结 有 末 ， 用 Log4J 打 印 输出 Track 对 象 的 ttte 和 playTime 属 

性 。 最 后 看 看 例 13-13。 


例 13-13: 重新 实现 的 AlbumTest 





package com.oreilly.hh; 
import java.sgl.Time; 
import java.util.*; 





import 
import 
import 


/** 





ct ct ct 














org.apache.log4j.Logger; 
com.oreilly.hh.dao.*; 
com.oreilly.hh.data.*; 








*Create sample album data, lett 


*/ 





ing Hibernate persist it for us. 


public class AlbumTest implements Test{ 
private static Logger log=Logger.getLogger (AlbumTest.class) ; 








private AlbumDAO albumDAo; @ 
private ArtistDAO artistDAO; 
private TrackDAO trackDAO; 





public void run () { 


//Retrieve (or create) an Artist matching this name 











Artist artist=artistDAO.getArtist ("Martin L.Gore", true); 四 
//Create an instance of album, add the artist and persist it 











//to the database. 


Album album=new Album ("Counter! 








Feit e.p." 1; 


new HashSet<Artist> O , new HashSet<String> () ， 
new ArrayList<AlbumTrack> (5) , new Date O ) ; 








//Add two album tracks 

addAlbumTrack (album, "Compulsio 
Time.valueOf ("00: 05: 29"), artist, 1, 1); 
addAlbumTrack (album, "In a Mann 

















"voll/album83/track02.m 





artist, 1, 2) 5 
//persist the album 





album.getArtists () .add (artist) ; 
album=albumDAO.persist (album) ; ® 


n", "voll/album83/track01.mp3", 





er of Speaking", 





p3", Time.valueOf ("00: 04: 21") , 


album=albumDAO.persist (album) ; @ 








log.info (album) ; 
} 
/** 


*Quick and dirty helper method 


creating 








O 


*album tracks.A real 
flexibility. 


*/ 





to handle repetitive portion of 











implementation would have much more 


private void addAlbumTrack (Album album, String title, String 


file, 





Time length, Artist 


artist, int 


disc, 





int positionOnDisc) 


{ 


//Create a new Track object and add the artist 


Track track=new Track (title, fi 


> 








le, length, new HashSet<Artist> 





new Date () , new StereoVolume () , SourceMedia.CD,; 
new HashSet<String> O) ) ; 
track.getArtists ©) .add (artist) ; 

//Persist the track to the database 

















track=trackDAO.persist (track) ; 

//Add a new instance of AlbumTrack with the persisted 

//album and track objects 

album.getTracks () .add (new AlbumTrack (track, disc, 
positionOnDisc) ) ; 

} 

public AlbumDAO getAlbumDAO () {return albumDAO; } 

public void setAlbumDAO (AlbumDAO albumDAO) { 

this.albumDAO=albumDAO; 

} 

public ArtistDAO getArtistDAO () {return artistDAO; } 

public void setArtistDAO (ArtistDAO artistDAO) { 

this.artistDAO=artistDAO; 

} 

public TrackDAO getTrackDAO () {return trackDAO; } 

public void setTrackDAO (TrackDAO trackDAO) { 

this.trackDAO=trackDAO; 

} 

} 



































AlbumTest 比 CreateTest 和 QueryTest 都 要 更 复杂 ， 因 为 它 要 处 理 多 个 
对 象 的 创建 和 持久 化 ， 以 及 关联 效果 。 可 以 逐步 看 看 它 的 代码 : 


@ 就 像 CreateTest 和 QueryTest 一 样 ，AlbumTest 类 也 定义 了 一 系列 私 
有 字段 来 引用 它 需 要 的 所 有 DAO 对 象 : trackDAO、artistDAO 以 及 
albumDAO。 


OdlbumTest fs 46 (# HartistDAO.getArtist © 取 回 一 个 Artist 对 象 ， 
如 果 这 个 方法 没有 找到 请 求 的 艺人 对 象 ， 就 会 创建 一 个 新 的 Artist 对 
象 。 





全 持久 化 Album 实 例 。 这 一 步 会 在 数据 库 中 创建 一 行 数据 ， 并 返回 
一 个 具有 非 null 值 id 属性 的 Album 对 象 。 我 们 现在 正在 持久 化 Album 记 


录 ， 这 样 束 能 够 使 用 新 的 Album 实 例 来 创建 多 个 Track 对 象 ， 再 把 它们 关 
联 到 这 个 新 的 Ablum 对 象 。 为 了 让 这 一 步 能 够 正常 运行 ， 需 要 确保 我 们 
的 Album 和 Track 对 象 均 具 有 非 null 的 id 属性 。 











@@ 接 着 再 增加 一 系列 Track 对 象 。 要 创建 Track 对 象 ， 我 们 首先 创建 
一 个 新 的 Track 实例 ， 再 用 trackDAO.persist () 方法 来 持久 化 该 Track 对 
Zo fEaddAlbumTrack O 方法 中 ， 我 们 创建 了 几 个 Track 对 象 ， 再 将 它 
们 与 Album 组 合 起 来 ， 放 到 AlbumTrack 关 系 对 象 中 。Album 上 的 tracks 属 
性 有 一 个 一 对 多 关系 ， 它 的 cascade 属 性 设置 为 CacscadeType.ALL， 所 以 
当 我 们 再 次 持久 化 专辑 对 象 时 ， 它 会 自动 在 ALBUM_TRACKS 表 中 创建 
相应 的 数据 行 。 


这 就 是 我 们 对 Test 接 口 的 实现 。 所 有 通用 的 处 理 已 经 转换 到 了 所 有 
DAO 的 持久 化 代码 中 ， 接 着 再 把 我 们 单独 的 CreateTest、QueryTest 以 及 
AlbumTest 关 移植 到 其 属性 引用 了 这 些 DAO 的 bean 中 ， 同 时 将 实际 的 测 
试 代 码 移植 到 Test 接 口 要 求 的 mm O 方法 中 。 这 样 ，Spring 就 可 以 将 所 
有 这 些 组 件 串 接 在 一 起 。 下 一 节 我 们 将 看 看 如 何 执行 这 些 测试 类 。 





TestRunner: 加 载 Spring ApplicationContext 


如 果 我 们 没 办 法 加 载 Spring 的 ApplicationContext， 并 执行 我 们 的 
Test 对 象 ， 前 面 的 所 有 代码 就 无 法 使 用 。 为 此 ， 我 们 要 创建 一 个 带 有 
static main () 方法 的 TestRunner 类 ， 并 从 我 们 的 Ant build.xml 中 调用 该 


方法 。 例 13-14 完 整地 列 出 了 TestRunner 类 的 内 容 。 这 个 类 负责 加 载 我 们 
的 Spring ApplicationContext， 取 回 一 个 Test 实 现 ， 并 执行 它 。 


例 13-14: 


加 载 Spring ApplicationContext 





package com.oreilly.hh; 


import 
import 


impor 














/** 








t org.apache.log4j.Logger; 

t org.apache.log4j.PropertyConfigurator; 

t org.springframework.context.ApplicationContext; 
import 

org.spring 











framework. context.support.ClassPathXmlApplicationContext; 





*A simple harness to run our tests.Configures Log4J, 
*creates an ApplicationContext, retrieves a bean from Spring 


EJ 
publi 
priva 





c class TestRunner{ 





te static Logger log; 














public static void main (String[]args) throws Exception{ 


//Con 
Prope 














1 





figure Log4J from a properties file 








rtyConfigurator.conf 


gure ( 


TestRunner.class.getResource ("/log4j.properties") ); Q 














log.inf 








ApplicationContext contex 


new C 


log=Logger.getLogger (TestRunner.class) ; 
//Load our Spring Application Context 
log.info ("Initializing TestRumnnex......") ; 

fo ("Loading Spring Configuration....") ; 








lassPathXmlApplicationContext ("applicationContext.xml") ; 





//Ret 
//run 
SE 
log.i 


rieve the test name 
the test. 
g testName=args[0]; 























from the command line and 





nfo ("Running test: 


"+testName) ; 











Test 
test 
} 
} 








test= (Test) context.getBean (testName) ; @ 


.run O; 





TestRunner 负 责 为 我 们 做 三 件 事 情 ， 如 JavaDoc 中 所 示 : 


Oik 





过 引用 类 路 径 的 根 目 录 下 的 log4j.properties 来 配置 Log4J。 


四 使 用 ClassPathXmlApplicationContex 对 象 来 创建 一 个 Spring 的 
ApplicationContext 对 象 。ClassPathXmlApplicationContext 的 构造 函数 接 
受 一 个 字符 串 参 数 ， 用 这 个 参数 来 指明 Spring XML 配置 文件 在 类 路 径 中 
的 位 置 。 在 这 个 例子 中 ， 我 们 的 applicationContext,xml 位 于 类 路 径 的 根 
目录 〈 紧 挨 着 log4j.properties 文 件 ) 。 


全 最 后 ， 我 们 从 命令 行 参数 中 得 到 bean 的 名 称 ， 再 从 
ApplicationContext 中 取 回 相应 的 Test 对 象 。 可 以 看 到 ， 从 
ApplicationContext 中 取 回 特定 名 称 的 bean 是 非常 容易 的 ， 只 需要 调用 


context.getBean (ZP) ， 再 将 取 回 的 结果 转换 为 想 要 的 类 型 。 


运行 CreateTest、QueryTest 以 及 AlbumTest 


为 了 运行 TestRunner， 并 从 我 们 的 Spring ApplicationContext 中 取 回 
正确 的 bean 对 象 ， 还 需要 修改 我 们 的 Ant build.xml 脚 本 。 找 到 名 为 
ctest、gqtest 以 及 atest 的 构建 目标 ， 修 改 它们 以 包含 以 下 XML， 如 例 13-15 
所 示 。 


例 13-15: 从 Ant 中 执行 TestRunner 








<target name="atest"description="Creates and persists some album 
data" 

depends="compile"> 

<java classname="com.oreilly.hh.TestRunner"fork="true"> 

<classpath refid="project.class.path"/> 

<arg value="albumTest"/> 











</java> 

</target> 

<target name="ctest"description="Creates and persists some sample 
data" 

depends="compile"> 

<java 
classname="com.oreilly.hh.TestRunner"fork="true"failonerror="true"> 

<classpath refid="project.class.path"/> 

<arg value="createTest"/> 

</java> 

</target> 

<target name="qgtest"description="Runs a query"depends="compile"> 

<java classname="com.oreilly.hh.TestRunner"fork="true"> 

<classpath refid="project.class.path"/> 

<arg value="queryTest"/> 

</java> 

</target> 












































TestRunner 关 使 用 它 的 第 一 个 命令 行 参数 作为 要 从 Spring 
ApplicationContext 获 取 的 bean 的 名 称 。 在 build.xml 中 ， 我 们 在 调用 
TestRunner 时 ， 就 将 bean (CapplicationContext.xml 中 的 ) 的 名 称 作 为 参数 
传递 给 它 。 


为 了 创建 测试 数据 库 ， 像 平常 那样 运行 ant schema; 为 了 将 数据 插 
入 到 数据 库 中 ， 则 需要 运行 我 们 新 版 本 的 ant ctest: 





Sant schema 

Sant ctest 
Buildfile: build.xml 
prepare: 

compile: 

ctest: 
[java] INFO TestRunner: 20-Initializing TestRunnev..... 
[java] INFO TestRunner: 21-Loading Spring Configuration... 
[java] INFO TestRunner: 25-Running test: createTest 

BUILD SUCCESSFUL 

Total time: 3 seconds 









































和 


运行 ant qtest， 以 调用 新 的 QueryTest 示 例 ， 并 确认 我 们 组 装 起 来 的 
所 有 东西 是 否 可 以 正常 工作 : 





Sant qtest 
Buildfile: build.xml 
prepare: 

compile: 

qtest: 
[java] INFO TestRunner: 20-Initializing TestRunnev..... 

ava] INFO TestRunner: 21-Loading Spring Configuration... 

ava] INFO TestRunner: 25-Running test: queryTest 

ava] INFO QueryTest: 25-Track: "Russian Trance", 00: 03: 30 

ava] INFO QueryTest: 25-Track: "Video Killed the Radio Star", 00: 

















Poche oa 








ot. ok. oe E I | 


03: 


A 
WO 




















[java] INFO QueryTest: 25-Track: "Test Tone 1", 00: 00: 10 


BUILD SUCCESSFUL 
Total time: 3 seconds 




















最 后 ， 我 们 可 以 运行 新 的 AlbumTest 示 例 。 输 入 ant atest 命 令 ， 你 应 
该 能 够 看 到 以 下 输出 内 容 : 





Sant atest 
Buildfile: build.xml 
prepare: 

compile: 

atest: 
[java] INFO TestRunner: 16-Initializing TestRunnev..... 

ava] INFO TestRunner: 17-Loading Spring Configuration... 

ava] INFO TestRunner: 21-Running test: albumTest 

ava] INFO AlbumTest: 40-Persisted Album: 1 

ava] INFO AlbumTest: 59-Saved an album named Counterfeit e.p. 
ava] INFO AlbumTest: 60-With 2 tracks. 

BUILD SUCCESSFUL 

Total time: 2 seconds 



































Ate AS ae. Le ik 
































一 切 正常 ， 现 在 还 要 做 什么 





Spring Framework 和 Hibernate 彼 此 取长补短 ， 配 合 得 相当 默契 。 如 
果 你 准备 在 一 个 大 型 应 用 程序 中 采用 Hibernate， 则 应 该 考虑 在 Spring 
Framework 的 基础 上 来 构建 你 的 应 用 程序 。 在 你 投入 时 间 学 会 了 这 种 框 
架 以 后 ， 我 们 相信 你 会 发 现 为 事务 处 理 、 连 接管 理 以 及 Hibernate 
Session 管 理 而 编写 的 代码 数量 一 定 会 有 所 减少 。 在 这 些 常 规 任务 上 人 花费 
的 时 间 越 少 ， 就 可 以 投入 更 多 的 时 间 到 你 的 应 用 程序 特定 的 需求 和 业务 
逻辑 处 理 上 。 可 移植 性 (portability) 是 使 用 Spring (或 任何 类 似 的 IoC 
容器 ) 和 DAO 模 式 的 另 一 个 原因 。 虽 然 Hibernate 是 目前 众多 持久 化 库 中 
的 首选 ， 但 也 说 不 定 在 未 来 的 10 年 中 又 会 冒 出 什么 新 技术 。 如 果 你 将 
Hibernate 特 定 的 代码 与 应 用 程序 的 其 他 部 分 隔离 开 来 ， 万 一 要 试验 下 一 
种 什么 新 技术 时 ， 就 方便 多 了 。 














注意 : Spring 确实 可 以 负责 许多 乏味 的 工作 。 但 这 不 应 该 成 为 我 们 


不 去 学 习 Hibernate 细 节 的 一 个 借口 。 


当 和 Spring 配合 使 用 时 ， 小 心 不 要 被 Hibernate 的 简单 性 所 迷惑 。 本 
书 的 几 位 作者 一 致 同意 ， 虽 然 Hibernate 是 一 件 非 常 好 的 东西 ， 但 有 时 也 
会 因为 某 些 原 因而 很 难 调试 和 诊断 Hibernate: 输入 错 了 的 一 个 字符 、 没 
有 正确 映射 的 数据 表 、 稍 微 不 正 确 的 ftush《〈 刷 新 ) 模式 或 者 是 一 些 神 秘 
的 JDBC 驱 动 程 序 的 不 兼容 问题 。Spring 之 所 以 让 Hibernate 变 得 容易 ， 是 
因为 它 提供 了 一 些 实用 的 抽象 ， 让 你 的 操作 变 得 更 简单 。 但 是 这 样 的 简 
单 性 减少 了 需要 直接 在 数据 库 中 执行 SQL 语句 的 机 会 ， 让 你 更 加 脱离 底 














层 细节 。 虽 然 你 可 能 不 必 自 己 编写 事务 处 理 代 码 ， 但 在 遇 到 问题 时 ， 这 
些 抽 象 也 让 你 更 难 诊断 出 产生 错误 的 根本 原因 。 不 要 误解 ， 我 是 不 会 脱 
离 Spring 而 单独 使 用 Hibernate 的 ， 但 是 如 果 你 牢固 地 掌握 好 了 Hibernate 
的 底层 细节 ， 那 么 就 能 更 快 地 诊断 出 问题 是 出 在 了 哪儿 。 





在 下 一 章 ， 我 们 将 向 你 展示 更 高 级 的 技术 一 如 何 将 Hibernate 集 成 到 
一 个 称 为 Stripes 的 Web 应 用 程序 框架 中 。 在 这 个 Web 程 序 框架 中 ， 你 将 
看 到 如 何 将 Spring 作为 Stripes 和 Hibernate 之 间 一 个 中 立 的 代理 。 在 你 阅 
读 学 习 下 一 章 时 ， 你 应 该 牢记 一 个 事实 : 目前 使 用 的 大 多 数 流行 的 Web 
应 用 程序 框架 都 提供 了 与 Spring 直接 集成 的 某 种 功能 。 如 果 你 使 用 的 是 
Struts 2、Wicket 或 者 Spring MVC， 它 们 中 的 许多 概念 是 相同 的 。Spring 
是 软件 的 Rosetta.Stone〈 译 加 ) ， 在 你 接受 它 以 后 ， 就 可 以 访问 为 与 
Spring 集成 而 设计 的 所 有 开发 库 。 以 Spring 作为 基石 ， 你 就 可 以 随 着 需 
求 的 改变 而 更 容易 地 在 不 同 技术 之 间 进 行 转换 。 比 如 ， 不 用 Java， 而 是 
用 JRuby 或 Groovy 来 编写 DAO 组 件 ， 使 用 Quartz 来 集成 cron-like 表 达 式 ; 
以 及 使 用 像 Apache CXF 之 类 的 库 将 服务 对 象 发布 为 SOAP 服 务 端点 等 。 





[1] 美国 Rosetta Stone ( 罗 赛 塔 石碑 语言 学 习 软 件 ) 是 风靡 世界 的 多 媒体 


英语 教学 软件 。 


B14% MAH: 用 Stripes 集 成 Spring 和 


Hibernate 





在 最 近 的 几 年 中 ， 各 种 Java Web 框 架 如 雨后春笋 快速 兴起 。 过 去 一 

段 时 间 内 ，Struts 被 认为 是 事实 上 的 Web 应 用 程序 的 Java 框 架 ， 但 现在 人 
们 意识 到 还 有 各 种 选择 可 以 使 用 。Java Server Faces (JSF) 在 企业 空间 
中 占有 一 定 的 份额 ，Spring MVC 随 Spring Framework 也 安装 到 许多 应 用 
中 ， 不 过 ， 发 现 Stripes 的 开发 人 员 也 会 经 常 选择 这 种 框架 。Stripes 的 知 
名 度 虽 然 没 有 Spring 那么 大 ， 但 是 众所周知 ， 市 场 成 功 并 不 总 是 直接 由 
品质 决定 的 。Stripes 就 是 那 种 默默 无 闻 ， 却 又 做 出 了 很 多 非 同 寻常 的 成 
PARHEZ =~ 





如 果 你 对 茶 种 Web 开 发 框架 很 有 经 验 ， 可 能 会 注意 到 有 很 多 方法 可 
以 将 Java 代 码 和 URL 以 及 表单 提交 绑 定 起 来 。 这 些 方法 中 的 大 多 数 都 需 
要 用 复杂 的 XML 和 Java 代 码 来 做 些 非 同 寻常 的 处 理 ， 它 们 如 此 复杂 和 难 
以 使 用 ， 以 至 于 很 多 人 放弃 使 用 Java 作 为 Web 应 用 程序 的 开发 工具 ， 
为 这 将 以 牺牲 实现 速度 作为 代价 。 放 弃 Java 框 架 ， 也 就 错过 了 已 经 用 
Java 开 发 的 众多 优秀 的 开发 框 染 ， 也 与 这 种 功能 丰富 的 开发 语言 失 之 交 
臂 。 我 们 的 感觉 是 Java 提 供 的 东西 非常 多 ， 然 而 Stripes 通 过 充分 利用 
Java 的 功能 和 一 致 的 体系 结构 ， 解 除了 以 往 Java Web 开 发 中 的 诸多 痛 
否 。 里 然 大 多 数 开 发 人 员 会 有 更 好 的 决断 ， 但 Struts 在 相当 长 的 一 段 时 








闻 内 垄断 了 Java Web 框 架 。Tim Fennell 之 所 以 要 创建 Stripes， 就 是 为 了 
取代 Struts Web 框 架 ， 因 为 他 不 喜欢 将 所 有 东西 都 放 在 struts-config.xml 
中 ， 更 不 喜欢 为 了 完成 简单 的 任务 还 得 管理 很 多 配置 文件 ( 山 )。 他 
以 Java 5 和 Servlet 2.4 作 为 项 目的 起 点 ， 就 能 够 对 Java Web 开 发 的 现状 进 
行 一 定 的 改进 。 对 于 原来 Struts 中 大 部 分 繁琐 的 任务 ，Stripes 则 通过 合理 
的 默认 值 、 反 射 Creflection) 、 标 注 、 基 于 泛 型 的 类 型 推导 (type 
inference) 来 加 以 简化 。 结 果 ，Stripes 就 成 为 一 种 简洁 、 易 于 理解 和 扩 
展 的 开发 框架 ， 让 Java Web 开 发 变 成 了 一 件 有 趣 的 事 。 








安装 Stripes 


Stripes A C) 的 目标 就 是 要 简化 开发 人 员 的 生活 。 为 此 ， 对 配 
置 提出 一 定 的 约定 ， 当 应 用 程序 广泛 使 用 默认 设置 时 ， 也 有 办 法 可 以 修 
改 这 些 默认 设置 。 就 像 在 前 面 介 绍 Spring 的 那 章 一 样 ， 我 们 并 不 打算 完 
整地 介绍 Stripes 为 开 肥 人 员 提 供 的 所 有 友好 的 功能 ， 只 是 希 望 你 可 以 通 
过 我 们 的 介绍 而 明白 Stripes 是 什么 ， 以 及 如 何 让 它 同 Spring 和 Hibernate 
协同 工作 。 作 为 开始 ， 最 好 是 先 了 解 几 个 与 Stripes 应 用 程序 有 关 的 概 
念 。 昌 然 你 只 需要 负责 与 ActionBean 和 视图 打交道 ， 也 应 该 明白 Stripes 








实现 的 DispatcherServlet 和 StripesFilter 的 工作 原理 。 


DispatcherServlet 


在 Stripes 应 用 程序 中 ， 通 常 只 有 一 个 J2EE HttpServlet 接 口 的 实现 ， 
由 Stripes 的 Dispatcher-Servlet 为 你 提供 这 个 实现 。DispatcherServlet 监 听 
到 来 的 URL 请 求 ， 再 决定 应 该 实例 化 哪个 ActionBean， 以 及 应 该 调用 那 
个 ActionBean 上 的 什么 方法 。 可 以 将 Dispatcher 看 做 是 应 用 程序 的 “管理 
器 ”。 当 请 求 到 达 应 用 程序 时 ，Dispatcher 会 检查 请 求 ， 再 决定 应 该 将 这 
个 请 求 委托 给 程序 的 哪 部 分 负 贡 处 理 。 按 照 约定 ， 一 般 将 
DispatcherServlet 映 射 到 *.action URL. 


StripesFilter 





StripesFilter 封 装 了 程序 要 处 理 的 所 有 HITP 请 求 。 当 直接 请 求 一 个 
JSP 时 ，StripesDispatcher 就 不 会 有 机 会 运行 ， 这 时 就 得 由 StripesFilter 负 
责 为 JSP 和 ActionBean 提 供 一 些 Stripes 的 特定 功能 ， 二 者 的 处 理 方式 差 不 
多 是 一 样 的 。StripesFilter 可 以 执行 对 multipart 类 型 的 表单 的 处 理 、 本 地 
化 选择 、flash scope (BI) 以 及 last stop 异 常 处 理 。 


ActionBean 


当 编 写 ActionBean 时 ， 就 可 以 真正 看 到 Stripes 的 可 贵 之 处 。 这 个 接 
口 只 需要 为 一 个 名 为 context 的 属性 配备 一 个 getter 和 setter 方 法 ，context 
将 是 ActionBeanContext 的 一 个 实例 。DispatcherServlet 使 用 ActionBean 上 
的 反射 ， 以 及 HTTP 请 求 参数 和 ActionBean 中 的 标注 ， 就 可 以 决定 应 该 
运行 什么 方法 。 


除了 setContext () 和 getContext () 方法 ，ActionBean 还 可 以 包含 
几 个 返回 Resolution 的 方法 ， 以 及 用 于 同 视图 进行 交互 的 属性 存 取 器 
Caccessor) 。 稍 后 我 们 开始 构建 示例 时 ， 你 就 会 明白 这 里 说 的 这 些 概 
念 是 什么 意思 了 。 你 的 ActionBean 不 必 进 行 类 似 
HttpRequest.getParameter () 之 类 的 调用 ， 因 为 Stripes 可 以 自动 负责 将 
请 求 参 数 绑 定 到 对 象 。 





视图 


Stripes 使 用 JSP 作 为 它 的 视图 技术 。 当 ActionBean 将 请 求 转发 到 JSP 
时 ，Stripes 会 为 JSP 提 供 一 个 对 该 ActionBean 的 引用 ， 以 便 可 以 用 JSTL 
表达 式 语 言 来 取出 ActionBean 中 的 数据 。 反 之 ， 在 JSP 中 可 以 用 
useActionBean 标 签 来 调用 某 个 ActionBean 的 事件 处 理 器 ， 以 便 为 显示 准 
备 请 求 〈 例 如 通过 格式 化 属性 ) 。Stripes 也 提供 了 一 个 简单 的 JSP 标 签 
库 ， 来 帮助 链接 应 用 程序 的 各 个 部 分 和 提供 表单 。 


[1] 参见 http:/ /stripesframework.org/display/stripes/Stripest+vs.+Struts. 

[2] http://stripesframework.org/. 

[3] flash scope 是 一 个 概念 ， 其 本 质 是 临时 储存 一 些 属性 给 (并且 仅 给 ) 
下 一 个 请 求 使 用 ， 使 用 过 后 便 被 清除 掉 。 


准备 Tomcat 


我 们 假设 你 已 经 有 了 一 个 可 以 跑 起 来 的 Apache Tomcat 环 境 ， 还 需 
要 确保 拥有 Tomcat 环 境 的 manager (管理 员 ) 角色 的 用 户 身份 。 可 以 修 
改 这 些 安全 配置 的 地 方 是 SCATALINA_HOME/conf/tomcat-users.xml， 
请 按 例 14-1 所 示 的 内 容 来 调整 你 的 tomcat-users.xml 文 件 。 


») 


例 14-1: 在 tomcat-users.xml 中 定义 一 个 manager 角 色 








<?xml version='1.0'encoding='utf-8'?> 

<tomcat-users> 

<role rolename="manager"/> 

<role rolename="tomcat"/> 

<role rolename="rolel"/> 

<user username="tomcat"password="tomcat"roles="tomcat, manager"/ 















































<user username="both"password="tomcat"roles="tomcat, rolel"/> 
<user username="rolel"password="tomcat"roles="rolel"/> 
</tomcat-users> 

















如 果 在 tomcat-users.xml 中 新 添加 了 一 个 manager 角 色 ， 则 需要 保存 
该 文件 ， 并 重新 局 动 Tomcat。 接 下 来 就 可 以 开始 创建 Stripes 应 用 程序 
Je 


创建 Web 应 用 程序 


既然 Tomcat 实 例 已 经 可 以 跑 起 来 了 ， 接 下 来 就 开始 创建 一 个 Web 应 
用 程序 。 首 先 ， 要 在 你 的 项 目 目 录 中 为 我 们 的 Web 应 用 程序 创建 目录 结 
构 ， 如 例 14-2 所 示 。 你 可 以 自己 手工 创建 这 个 目录 ， 也 可 以 从 本 书 的 网 
站 下 载 代码 示例 。 


例 14-2: 创建 Web 应 用 程序 目录 结构 的 命令 

















Smkdir-p webapp/WEB-INF 








作为 开始 ， 我 们 要 在 应 用 程序 中 加 入 一 个 web.xml 和 index.jsp 文 件 ， 
并 部 署 它 们 。 每 个 J]2EE Web 应 用 程序 都 需要 一 个 web.xml 文 件 ， 所 以 我 
们 就 先 从 这 儿 开 始 。 稍 后 我 们 再 用 Filter 和 Servlet 标 签 来 配置 这 个 文件 ， 
不 过 现在 就 把 这 个 只 有 空 架子 的 web.xml 文 件 放 在 webapp/WEB-INF 中 
了 ， 如 例 14-3 所 示 。 


例 14-3: 最 简单 的 webapp/WEB-INF/web.xml 文 件 





<?xml version="1.0"encoding="UTF-8"?> 

<web-app xmlns="http://java.sun.com/xml/ns/j2ee" 

xmins: xsi="http://www.w3.org/2001/XMLSchema-instance" 

xsi: schemaLocation="http://java.sun.com/xml/ns/j2ee 

http://java.sun.com/xml/ns/j2ee/web-app 2 4.xsd"version="2.4"> 

</web-app> 
[ee | 





—“SWeb HIET ERORA AMARRA REE, MARITIEM 
用 程序 的 根 目 录 (webapp/) 下 添加 一 个 非常 简单 的 index.jsp 文 件 。 表 一 
次 ， 我 们 还 不 准备 搞 些 花哨 的 风格 样式 ; 我 们 只 需要 页 面 上 能 有 些 内 
容 ， 好 让 我 们 知道 有 东西 在 运行 就 可 以 了 。 代 码 如 例 14-4 所 示 。 











例 14-4: 一 个 简单 的 JSP 文 件 webapp/index.jsp 





<?xml version="1.0"?> 
<%@page contentType="text/html; charset=UTF-8"language="java"%s> 
Hello World 











H BIC Dy A PE E Tomcat A EPA, PRAY UAB EA 
欢 的 任何 方法 。 我 比较 喜欢 用 Ant deploy WA) 构建 任务 将 上 下 文 信 
恩 肥 送 到 Tomcat。 在 应 用 程序 上 下 文 配 置 文件 中 可 以 指定 docBase， 告 
诉 Tomcat 到 哪儿 去 找 开 发 位 置 上 的 应 用 程序 。 采 用 这 种 部 罗技 巧 ， 你 只 
需要 部 着 一 次 应 用 程序 。 将 程序 部 效 到 Tomcat 可 能 会 伦 不 少时 间 ， 上 所 以 
与 每 次 都 需要 部 署 程 序 相 比 ， 采 用 这 种 办 法 以 后 ， 你 的 编译 和 测试 周期 
将 会 变 得 更 快 。 














为 了 运行 应 用 程序 ，Tomcat 还 需要 知道 一 些 与 之 相关 的 信息 。 为 
Tomcat 提 供 信 息 的 一 种 方法 就 是 将 这 些 信息 放 在 context 文 件 中 (如 例 
14-5 所 示 ) 。 我 们 需要 让 Tomcat 知 道 的 主要 事情 就 是 应 用 程序 的 位 置 。 











例 14-5: 一 个 tomcat-context.xml 文 件 的 例子 





<?xml version="1.0"?> 

<Context 
docBase="/home/rfowler/current/examples/ch14/webapp"® 
debug="0" 

reloadable="true"@ 

> 

</Context> 

















@docBase 属 性 用 于 指定 应 用 程序 将 位 于 Tomcat 服 务 器 的 文件 系统 
的 哪个 位 置 。 你 需要 将 这 个 属性 修改 为 你 的 计算 机 中 应 用 程序 的 实际 位 
=. 


全 Context 的 reloadable 属 性 用 于 指定 Tomcat 是 否 应 该 监视 应 用 程序 
类 文件 的 变化 ， 并 在 有 变化 时 重新 加 载 应 用 程序 的 上 下 文 。 打 开 重 新 加 
载 可 以 方便 我 们 的 开发 周期 ， 但 是 当 应 用 程序 发 布 为 产品 以 后 ， 则 会 浪 
费 一 定 的 CPU 周期 。 

















现在 ， 我 们 已 经 编写 好 了 一 个 context 文 件 ， 接 下 来 就 更 新 build.xml 
文件 ， 以 便 可 以 部 署 应 用 程序 。 在 本 章 的 构建 文件 中 还 需要 添加 几 个 依 
赖 文件 ， 我 们 打算 将 所 有 的 修改 内 容 都 一 次 性 复制 到 这 里 ， 如 例 14-6 所 


ZN o 





(914-6: build.xml 中 新 添加 的 Tomcat 依 赖 





<artifact: dependencies pathId="dependency.class.path" 
filesetid="dependency.fileset"> 
<dependency groupid="hsqldb"artifactId="hsgqldb"version="1.8.0.7"/ 






































<dependency groupId="mysql"artifactId="mysql-connector-java" 
version="5.0.5"/> 











<dependency groupId="o0rg.hibernate"artifactId="hibernate" 
version="3.2.5.ga"> 
<exclusion groupId="javax.transaction"artifactId="jta"/> 
</dependency> 
<dependency groupId="org.hibernate"artifactId="hibernate-tools" 
version="3.2.0.beta9a"/> 

<dependency groupId="o0rg.apache.geronimo.specs" 
artifactId="geronimo-jta_1.1 spec"version="1.1"/> 

<dependency groupId="log4j"artifactId="log4j"version="1.2.14"/> 


























































































































<dependency 
grouplId="javax.servlet"artifactId="jstl"version="1.1.1"/> 

<dependency 
grouplid="taglibs"artifactId="standard"version="1.1.1"/> 

<dependency groupId="o0rg.hibernate"artifactId="hibernate- 




















annotations" 
version="3.3.0.ga"/> 
<dependency groupId="org.hibernate" 
artifactId="hibernate-commons-annotations" 
version="3.3.0.ga"/> 
<dependency groupId="org.springframework"artifactId="spring" 
version="2.5"/> 






























































<dependency groupId="commons-dbcp"artifactId="commons-dbcp" 
version="1.2.2"/> 

<dependency groupId="net.sourceforge.stripes"artifactId="stripes" 
version="1.4.3"/>@ 





<dependency groupId="tomcat"artifactId="servlet- 
api"version="5.5.12"/>@ 
<dependency groupId="tomcat"artifactId="catalina-ant" 
version="5.5.15"/>®@ 
<dependency groupId="tomcat"artifactId="jasper-compiler" 
version="5.5.15"/> 
<dependency groupId="tomcat"artifactId="jasper-runtime" 
version="5.5.15"/>@ 
</artifact: dependencies> 






























































@Stripes 这 个 artifact 配 置 提供 了 使 用 Stripes 框 架 所 需要 的 jar 库 。 





人 @servlet-api 这 个 artifact 配 置 提供 了 包含 J2EE Servlet 接 口 和 文 持 类 
的 库 。HttpServletRequest 和 HttpServletResponse 类 都 是 由 这 个 artifact 提 供 
的 。 


@catalina-ant artifact Id 提供 了 一 些 用 于 同 运行 的 Apache Tomcat 实 例 
进行 交互 的 Ant 构 建 任 务 。 简 单 来 说 ， 你 将 在 构建 文件 中 增加 一 个 新 的 
构建 目标 ， 它 会 用 到 来 自 这 个 artifact 的 Tomcat 的 deploy 构 建 任务 。 





四 jasper-compiler 和 jasper-runtime 这 两 个 artifact， 除 了 catalina-ant 以 


外 ，Tomcat 的 deploy 标 签 也 需要 它们 。 


到 这 以 后 ， 下 一 步 就 是 用 taskdef 建 立 Catalina Ant 构 建 任务 ， 为 部 署 
应 用 程序 定义 一 个 新 的 target。Ant 的 deploy 构 建 任务 将 为 Tomcat 发 送 一 
个 tomcat-context.xml 文 件 〈 例 14-5) ， 包 括 身 份 认证 信息 和 context 路 
径 ， 如 例 14-7 所 示 。 


例 14-7: 用 于 部 署 应 用 程序 的 Ant 构 建 目 标 





<taskdef name="hibernatetool" 
classname="org.hibernate.tool.ant.HibernateToolTask" 
classpathref="project.class.path"/> 

<! --Teach Ant how to use Tomcat's deploy task--> 

<taskdef name="deploy"classpathref="dependency.class.path" 
classname="org.apache.catalina.ant.DeployTask"/> 

<target name="db"description="Runs HSQLDB database management UI 
against the database file--use when application is not running"> 
<java classname="org.hsqldb.util.DatabaseManager" 

fork="yes"> 

<classpath refid="project.class.path"/> 

<arg value="-driver"/> 

<arg value="org.hsqldb.jdbcDriver"/> 

<arg value="-url"/> 

<arg value="jdbc: hsqldb: S{data.dir}/music"/> 

<arg value="-user"/> 

<arg value="sa"/> 

</java> 

</target> 





















































<target name="gtest3"description="Retrieve all mapped objects" 

depends="compile"> 

<java 
classname="com.oreilly.hh.QueryTest3"fork="true"failonerror="true"> 

<classpath refid="project.class.path"/> 

</java> 

</target> 

<target name="deploy"> 

<deploy url="http://localhost: 8080/manager"@ 

username="tomcat"password=' 'tomcat"@ 

path="/stripesapp"@ 

config="${basedir}/tomcat-context.xml"/>@ 

</target> 
































@Qdeploy 构 建 任务 的 url 属 性 用 于 指定 Apache Tomcat 提 供 的 manager 
servlet 的 URL。 


全 username 和 password 属 性 指定 管理 器 角色 的 用 户 身 份 验证 信息 ， 
这 些 信息 是 在 例 14-1 中 配置 的 。 





全 path 属 性 告诉 Tomcat， 应 用 程序 应 该 部 署 到 什么 上 下 文 路 径 。 


@config 属 性 指定 将 要 发 送 到 Tomcat 的 上 下 文 文件 。 这 个 文件 如 例 
14-5 所 示 。 





所 有 安排 妥当 以 后 ， 就 应 该 可 以 运行 ant deploy 命 令 〈 如 例 14-8 所 
示 ) ， 再 在 web 浏览 右 中 访问 我 们 简单 的 Web 应 用 程序 了 。 


例 14-8: 部 署 应 用 程序 





Sant deploy 


Buildfile: build.xml 

deploy: 

[deploy]OK-Deployed application at context path/stripesapp 
BUILD SUCCESSFUL 

Total time: 3 seconds 























上 面 示例 输出 中 的 "OK" 表 示 Tomcat 已 经 接受 了 新 的 应 用 程序 。 在 
en //localhost: 8080/stripesapp， 看 看 这 个 程序 是 否 存 
在 ， 运 行 的 对 不 对 。 在 默认 情况 下 ，Tomcat 将 会 查找 和 返回 Web 应 用 程 
序 根 目 录 下 的 index.jsp 文 件 。 因 此 ， 应 用 程序 应 该 在 浏览 器 中 显 
示 "Hello World"， 如 图 14-1 所 示 。 


Mozilla Hrefox 


File Edit View History Bookmarks Tools Help 


Lj http://flocalhost:8080/stripesapp/ Mra 


Hello World 


G | © | Adblock 








图 141 Tomcat © 73 "Hello World" 


BHT PAS 


虽然 我 们 刚才 进行 的 所 有 任务 和 Stripes 或 Hibernate 没 有 任何 关系 ， 


但 是 这 些 操 作为 使 用 Stripes 铺 平 了 道路 。 现 在 我 们 有 了 一 个 可 以 跑 起 来 
的 Apache Tomcat 安 装 实 例 ， 以 及 一 个 我 们 上 自己 创建 的 运行 民 好 的 Web 
应 用 程序 了 。 


增加 Stripes 





为 了 让 我 们 的 项 目 可 以 在 web 环境 中 运行 ， 需 要 对 compile 构 建 任务 
进行 一 些 修 改 。 到 现在 为 止 ， 我 们 一 直 在 用 Ant 来 启动 应 用 程序 ， 所 以 
要 为 Ant 提 供 正 确 的 代码 类 路 径 信息 。 目 前 一 切 运行 正常 ， 但 是 Tomcat 
的 类 加 载 管理 机 制 要 复杂 得 多 ， 因 此 ， 将 所 有 需要 的 依赖 文件 直接 复制 
到 应 用 程序 的 WEB-INF/ib 目 录 下 是 最 简单 的 方法 。 我 们 也 希望 编译 任 
务 可 以 将 文件 放 在 WEB-INF 中 ， 这 样 Tomcat 就 可 以 直接 找到 它们 。 参 
见 例 14-9。 


例 14-9: 针对 Web 应 用 程序 而 修改 Compile 构 建 任务 





<property name="source.root"value="src"/> 
<property name="class.root"value="webapp/WEB-INF/classes"/>@ 
<property name="data.dir"value="webapp/WEB-INF/data"/>@ 



































<target name="compile"depends="prepare" 
description="Compiles all Java classes"> 
<javac srcdir="S{source.root}" 
destdir="${class.root}" 

debug="on" 
optimize="off" 
deprecation="on"> 

<classpath refid="project.class.path"/> 
</javac> 
<filter token="docroot"value="$ {basedir}/webapp"/>® 

<copy todir="webapp/WEB-INF"filtering="true"overwrite="true"> 
<fileset dir="src"includes="applicationContext.xml"/> 
</copy>@ 
<copy todir="webapp/WEB-INF/lib"flatten="true"> 
<fileset refid="dependency.fileset"/> 











































































































</copy>®@ 
</target> 


加 因为 我 们 正在 将 应 用 程序 移植 到 J2EE Web 应 用 程序 ， 所 以 需要 
把 Java 类 放 到 webapp/WEB-INF/classes 目 录 下 。 最 简单 的 实现 方法 就 是 
修改 class.root 属 性 值 。 








全 由 于 当前 的 工作 目录 还 不 能 确定 ， 所 以 HSQLDB 也 不 能 够 在 数据 
的 相对 路 径 中 找到 数据 库 。 因 此 ， 我 们 需要 为 Hibernate 提 供 数 据 库 的 完 
整 路 径 。 为 此 ， 创 建 一 个 data.dir 属 性 ， 当 复制 applicationContext.xml 文 
件 时 会 用 到 这 个 属性 。 


全 ant 的 filter 构 建 任务 指定 当 复 制 applicationContext.xml 时 ， 需 要 用 
Web 应 用 程序 的 实际 路 径 来 普 换 @docroot@ 标 记 。 


四 需要 将 Spring 的 applicationContext.xml 文 件 复制 到 webapp/WEB- 
INE 目 录 下 ， 以 便 Tomcat 可 以 找到 它 。 


加 既然 应 用 程序 不 再 由 Ant 来 启动 了 ， 我 们 也 就 不 能 再 依赖 本 地 
Maven 仓 库 中 找到 的 Java 库 。J2EE 规 范 要 求 把 Web 应 用 程序 的 JAR 文 件 
放 到 WEB-INF/ib 目 录 中 ， 所 以 这 一 步 就 是 将 我 们 需要 的 文件 从 Maven 
本 地 仓库 复制 到 WEB-INF/lib 目 录 中 。 


为 了 让 用 docroot 配 置 的 过 滤器 (filter〉 对 任何 目录 都 有 效 ， 我 们 需 


H 4F src/application-Context.xml (第 13 章 中 创建 的 ) 中 添加 @docroot@ 标 
记 ， 例 14-10 演 示 了 这 一 修改 。 


例 14-10: applicationContext.xml 中 数据 库 配 置 文件 位 置 的 变化 











<property name="hibernateProperties"> 


























te.show_sql">true</prop> 
te.format_sql">true</prop> 
te.transaction.factory class">org.hibernate. 








nsactionFactory</prop> 









































<props> 

<prop key="hiberna 

<prop key="hiberna 

<prop key="hiberna 

transaction.JDBCTra 

<prop key="hibernate.dialect 
</prop> 

<prop key="hibernate.connect 

<prop key="hibernate.connect 
</prop> 

<prop key="hibernate.connect 

<prop key="hibernate.connect 
org.hsqldb.jdbcDriver 

</prop> 

<prop key="hibernate.connect 
INF 

/data/music</prop> 

<prop key="hibernate.connect 

<prop key="hibernate.connect 

<prop key="hibernate.current 


= 
<prop key="hibernat 
</props> 
</property> 








tion. 
tion. 


tion. 
tion 





t">org.hibernate.dialect.HSQLDialect 





autocommit">false</prop> 
release mode">after transaction 








shutdown" >true</prop> 








tion 


tion. 
tion. 





.driver class"> 


-url">jdbc: hsqldb: @docroot@/WEB- 











username" >sa</prop> 
password" ></prop> 


t session context class">thread</prop 


te.jdbc.batch size">0</prop> 





现在 ， 我 们 的 构建 环境 已 经 修改 好 ， 可 以 开始 使 用 Stripes 了 。 为 了 
让 Spring、Hibernate 以 及 Stripes 协 同 工 作 ， 还 需要 对 web.xml 进 行 多 处 修 
改 。 例 14-11 中 演示 了 很 多 内 容 ， 但 每 个 配置 项 都 有 一 定 的 作用 。 稍 后 
将 介绍 一 下 其 中 重要 的 配置 。 








例 14-11: 


针对 Stripes 集 成 而 修改 后 的 web.xml 








<?xml version="1.0"encoding="UTF-8"?> 

<web-app xmlns="http://java.sun.com/xml/ns/j2ee" 
xmins: xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi: schemaLocation="http://java.sun.com/xml/ns/j2ee 
http://java.sun.com/xml/ns/j2ee/web-app 2 4.xsd" 
version="2.4"> 

<listener> 

<listener-class> 











framework.web.context.ContextLoaderListener 





org.spring! 


</listener-class>@ 

</listener> 

<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>/WEB-INF/applicationContext.xml</param-value> 








</context-param> 





























<! --Hiber 
<filter> 











nate OpenSession Filter--> 











<filter-name>hibernateFilter</filter-name>@ 

















<filter-cl 





ass> 








org.spring! 





Framework.orm.hibernate3.support.OpenSessionInViewFilter 








</filter-class> 

<init-param> 
<param-name>singleSession</param-name> 
<param-value>true</param-value> 
</init-param> 

<init-param> 
<param-name>sessionFactoryBeanName</param-name > 
<param-value>sessionFactory</param-value> 
</init-param> 

<init-param> 
<param-name>flushMode</param-name> 
<param-value>ALWAYS</param-value> 
</init-param> 














</filter> 
<filter> 























<display-name>Stripes Filter</display-name>® 





<filter-name>StripesFilter</filter-name> 














<filter-cl 


ass> 











net.sourcel 





fForge.stripes.controller.StripesFilter 


</filter-class> 

<init-param> 
<param-name>ActionResolver.PackageFilters</param-name> 
<param-value>com.oreilly.*</param-value> 








</init-param> 

<init-param> 
<param-name>ActionResolver.UrlFilters</param-name> 
<param-value >WEB-INF/classes</param-value> 
</init-param> 
<init-param> 
<param-name>Interceptor.Classes</param-name> 

<param-value> 
net.sourceforge.stripes.integration.spring.SpringInterceptor, 
net.sourceforge.stripes.controller.BeforeAfterMethodInterceptor 
</param-value> 

</init-param> 

</filter> 

<filter-mapping> 

<filter-name>hibernateFilter</filter-name> 
<url-pattern>*.jsp</url-pattern> 

<dispatcher >REQUEST</dispatcher> 

</filter-mapping> 

<filter-mapping> 

<filter-name>hibernateFilter</filter-name> 
<url-pattern>*.action</url-pattern> 

<dispatcher >REQUEST</dispatcher> 

</filter-mapping> 

<filter-mapping> 

<filter-name>StripesFilter</filter-name> 
<url-pattern>*.jsp</url-pattern> 

<dispatcher >REQUEST</dispatcher> 

</filter-mapping> 

<filter-mapping> 

<filter-name>StripesFilter</filter-name> 
<url-pattern>*.action</url-pattern> 

<dispatcher >REQUEST</dispatcher> 

</filter-mapping> 

<servlet> 
<servlet-name>StripesDispatcher</servlet-name>@ 
<servlet-class> 
net.sourceforge.stripes.controller.DispatcherServlet 
</servlet-class> 
<load-on-startup>1</load-on-startup> 

</servlet> 

<servlet-mapping> 
<servlet-name>StripesDispatcher</servlet-name> 
<url-pattern>*.action</url-pattern> 
</servlet-mapping> 

</web-app> 


es | 































































































































































































































































































@QContextLoaderListener 过 滤器 用 于 初始 化 Web 应 用 程序 的 Spring 


Framework. 


人 hibemateFilter 是 由 Spring 提供 的 ， 用 于 获取 一 个 封装 了 所 有 请 求 
处 理 的 Hibernate 会 话 。 使 用 这 个 功能 ， 我 们 就 可 以 不 必 再 目 己 管理 
Hibernate 会 话 。 这 一 功能 之 所 以 精彩 ， 是 因为 正确 的 会 话 管理 可 能 是 编 
写 支 持 Hibernate 的 Web 应 用 程序 时 最 具 技巧 性 的 处 理 之 一 。 





全 将 Stripes Filter 映 射 到 *.action 和 *.jsp HTTP 请 求 。 它 提供 了 调用 
JSP 或 ActionBeans 时 所 需 的 一 些 基 本 表单 处 理 和 配置 服务 。 


@StripesDispatcher servlet 映 射 到 了 *.action， 负 责 决定 应 该 调用 哪 
个 ActionBean 中 的 哪个 方法 ， 以 及 处 理由 这 些 事件 方法 返回 的 


Resolution 。 





| Stripes = Download - Mozilli Firefox 
Ble Edit View History Bookmarks pols Help 
X. http yymedj.org/confluencesdisplay/stripes/Download w|i 
: ——— a 


Stripes Downloads 








Downloads are hosted by SourceForge net 


There are two separate distribution files for Stripes, The reguler inen-source) 
distribution includes the compiled wersion of Stripes and the Examples application 
R aito inthades source-code for Stripes and the examples, but not a build 
environment Due to the desire to keep the distribution light and the size of some 
of the compile-time dependencies a second, source, distribution is also available. 
This distribution includes the Stripes source, the build environment and all build 
dependencies. R is only needed F you plan to build Stripes yourself. 


(Si.net File Releases: Stripes (stripes project) - Stripes is a java framework with 
the geal of making Serviet/JSP based web dewelopmert in java as easy, intuitive 
and straight-forward as it whould be. it's stripey and t doesn't suck. See 

htt p://stripes.mec4j.org for mora information.) 


shipes Stripes 1.4.3 released (Tue, 15 May 2007 11:51:08 GMT) 
Released at Toe 15 May 2007 1151-08 GMT by bengurter 


indudes flex strpes-1 4 Bap [2899637 byter 3903 doewrtoads to date), strees-1 4 Perc ap 
(4692352 bytes. 1349 downloads to date) 





图 14-2 Stripes FARR A 





在 开始 使 用 Stripes 以 前 ， 为 了 让 它 正 常 运行 ， 还 有 最 后 一 个 需要 安 
装 的 配置 。Stripes-Resources.properties 文 件 位 于 classes 类 目录 中 ， 它 为 
Stripes 提 供 一 些 必 需 的 格式 化 字符 串 。 对 于 这 个 例子 来 说 ， 最 简单 的 办 
法 就 是 用 下 载 的 随 书 示例 代码 ， 直 接 从 examples/ch14/src 目 录 中 复制 
StripesResources.properties 文 件 ， 不 过 也 可 以 从 Stripes 下 载 包 (由) 中 得 
到 这 个 文件 。 在 Stripes 1.4.3 下 载 页 面 的 中 间 ， 点 击 "Download" 按 钮 ， 如 
图 14-2 所 示 ， 继 续 链 接 到 SourceForge 下 载 页 面 ， 对 SourceForge 我 们 都 应 
该 很 熟悉 了 。 在 下 载 好 stripes-1.4.3.zip 以 后 ， 将 它 进 行 解 压 ， 再 把 
stripes-1.4.3/lib/StripesResources.properties 复 制 到 你 的 src 目 录 下 。 如 果 愿 








， 你 可 以 看 看 这 个 文件 的 内 容 ， 不 过 它 只 是 本 章 示 例 需 要 的 一 个 依赖 
文件 而 已 。 





最 后 就 应 该 编写 一 点 代码 了 。 首 先 ， 我 们 来 编写 两 个 JSP 文 件 ， 下 

接 独 开发 一 个 ActionBean。 如 果 你 最 近 几 年 写 过 些 JSP 代 码 ， 那 么 我 们 

在 这 儿 编 写 的 JSP 文 件 也 不 会 令 你 感到 陌生 。 不 过 ， 你 可 能 不 认得 的 是 

前 级 (prefix) 为 "stripes" 的 几 个 标签 。Stripes 标 签 库 可 以 作为 JSTL 的 补 

充 ， 辅 助 你 的 应 用 程序 类 和 视图 协同 工作 。 例 14-12 演 示 了 一 个 用 于 编 
辑 曲目 专辑 的 页 面 源 代 码 。 





例 14-12: 曲目 编辑 视图 : webapp/albums/edit.jsp 








<%@page contentType="text/html; charset=UTF-8"language="java"%s> 
<%@taglib prefix="c"uri="http://java.sun.com/jsp/jstl/core"%s> 
<S@taglib 

prefix="stripes"uri="http://stripes.sourceforge.net/stripes.tld"3>@ 
<stripes: useActionBean 
beanclass="com.oreilly.hh.web.AlbumActionBean" 
var="actionBean"event="edit"/>@ 
<h1l>Album Edit Page</hl> 
<stripes: form action="/Album.action">®@ 
<stripes: errors/> 
<stripes: hidden name="album.id"></stripes: hidden>@ 
<table> 

tr> 

td>Title: </td> 

td><stripes: text name="album.title"/></td>®@ 

/tr> 

tr> 

td>Discs: </td> 

<td><stripes: text name="album.numDiscs"/></td> 

</tr> 

</table> 

<h2>Album Comments</h2> 

<c: choose> 





















































<c: when test="S${actionBean.album.id! =null}"> 

<stripes: link href="/albums/edit comment.jsp"> 

<stripes: param name="album.id"value="${actionBean.album.id}"/> 
Add A Comment 

</stripes: link> 

<c: if test="S${empty actionBean.album.comments}"> 

There are no album comments yet. 

</ce: if> 

</c: when> 

<c: otherwise> 

Please add the album before entering comments. 

</c: otherwise> 

</c: choose> 

<ul> 

<c: forEach items="S${actionBean.album.comments}"var="comment" > 
<1i>S{comment}</1i> 

</c: forEach> 

</ul> 

<br/> 

<stripes: submit name="save"value="Save"></stripes: submit >@ 
</stripes: form> 







































































可 以 看 到 ， 这 是 一 个 外 观 界面 相当 普通 的 JSP 页 面 ， 不 过 ， 也 有 一 


些 东 西 值得 更 仔细 地 研究 一 下 : 


@taglib 声 明 用 于 引入 Stripes 标 签 库 ， 以 便 页 面 上 的 代码 可 以 通 
过 "stripes: "前 组 来 使 用 它们 。 


全 这 里 使 用 useActionBean 标 签 来 告诉 Stripes 初 始 化 


AlbumActionBean， 如 果 它 的 edit 事 件 没有 发 生 的 话 ( 例 如 ， 浏 览 器 直接 
请 求 JSP 页 面 ， 而 不 是 通过 action URL) ， 就 运行 这 个 事件 。edit 事 件 将 
会 从 数据 库 中 加 载 Album 对 象 ， 为 生成 表单 做 好 ;准备 。 





全 Stripes 的 form 标 签 会 输出 一 个 普通 的 HTML 表 单 ， 以 及 很 多 隐藏 


在 幕后 的 东西 。 它 的 action 属 性 指定 表单 将 要 提交 到 的 ActionBean。 


@Stripes 的 hidden 标 签 的 作用 类 似 于 普通 HTML 的 input 标 签 。 使 用 
Stripes 版 本 的 标签 的 好 处 是 : 它 的 值 是 自动 生成 的 。 


全 Stripes 的 text 标 签 可 以 创建 一 个 文本 输入 字段 (这 和 你 想到 的 应 
该 一 致 ) 。hidden 标 签 ， 它 可 以 自动 生成 其 value 属 性 的 值 。 


@Stripes 的 submit 标 签 会 生成 一 个 典型 的 提交 按钮 。 这 里 要 注意 的 

ye: submit 标 签 的 name 属 性 值 是 当 表 单 提交 时 要 调用 的 ActionBean 事 件 
处 理 方法 的 名 称 。 在 这 个 例子 中 ， 调 用 的 是 AlbumActionBean.save O 
本章 后 面 在 讨论 ActionBean 时 将 进一步 解释 事件 和 筷 们 的 处 理 右 ) o 


Stripes 也 有 一 个 label 标 签 ， 可 以 帮助 设置 本 地 化 Cocalization) 配 
置 ， 让 代码 保持 简洁 。 我 们 在 这 没有 使 用 它 ， 是 因为 想 只 关注 Hibernate 
的 东西 。 幸 好 Stripes 也 为 这 些 标签 提供 了 很 详细 的 文档 (14) 。 








这 个 页 面 写 好 以 后 ， 接 下 来 还 要 编写 一 个 用 于 列 出 数据 库 中 的 专辑 
的 页 面 ， 可 以 将 这 个 页 面 作为 一 个 加 载 页 面 ， 通 过 它 能 够 看 到 数据 库 中 
有 什么 信息 。 例 14-13 中 的 页 面 代码 看 起 来 比 editjsp 页 面 要 少 一 点 ， 不 


过 ， 要 注意 一 下 结尾 处 的 Stripes link 标 签 。 





例 14-13: 专辑 列表 视图 : webapp/albums/list.jsp 








<%@page contentType="text/html; charset=UTF-8"language="java"%s> 


<%@taglib prefix="cC"uri="http://java.sun.com/jsp/jstl/core"S> 
<S@taglib prefix="stripes" 
uri="http://stripes.sourceforge.net/stripes.tld"%> 
<stripes: useActionBean 
beanclass="com.oreilly.hh.web.AlbumActionBean" 
var="actionBean"event="list"/> 
<table> 
<tr> 
<th>title</th> 
< 
< 



































th>discs</th> 
th>action</th> 














<c: forEach items="S$f{actionBean.albums}"var="album"> 








<td>S${album.title}</td> 
<td>S${album.numDiscs}</td> 

<td><stripes: link href="/albums/edit.jsp"> 
<stripes: param name="album.id"value="$ {album.id}"/> 





























edit 

</stripes: link></td> 

</tr> 

</c: forEach> 

</table> 

<stripes: link href="/albums/edit.jsp">new</stripes: link> 














stripes: link 标 签 用 于 将 程序 和 HTML 锚 点 (anchor) 链接 起 来 ， 它 
提供 了 几 个 属性 ， 可 以 构建 指 癌 ActionBean 事 件 处 理 嚣 以 及 JSP 的 
URL. 


编写 ActionBean 








接 下 来 应 该 编写 一 个 ActionBean。 可 以 将 ActionBean 看 做 是 
MVC (Model, View. Controller) 模式 中 的 控制 器 组 件 。 例 14-14 演 示 
了 我 们 的 第 一 个 AlbumActionBean， 它 可 以 让 你 很 好 地 了 解 编写 


ActionBean 需 要 涉及 哪些 内 容 。 








这 个 类 中 的 方法 可 以 分 为 两 大 类 : 属性 存 取 器 和 事件 处 理 器 。 属 性 

存 取 器 就 像 其 他 Java Bean 的 setter 和 getter 方 法 一 样 ， 所 以 它们 看 起 来 也 
差不多 。 另 一 方面 ， 那 些 返 回 Resolution 的 方法 就 显得 有 些 陌生 了 ， 不 
过 其 概念 也 相当 简单 。 当 一 个 请 求 到 达 StripesDispatcher 时 ，HTTP 请 求 
中 的 某 个 部 分 就 可 以 指示 出 一 个 事件 的 名 称 ， 由 该 事件 的 处 理 器 负责 处 
理 这 个 HTTP 请 求 。 当 Stripes 请 求 的 生命 周期 经 过 它 的 
BindingAndValidation 阶 段 后 ， 就 会 调用 由 请 求 确 定 的 事件 处 理 器 方法 

CStripesDispatcher 使 用 反射 来 查找 其 名 称 和 事件 匹配 的 方法 ， 该 方法 返 
回 的 就 是 一 个 Resolution) 。 由 事件 处 理 器 返回 的 Resolution 对 象 接着 再 
由 StripesDispatcher 进 行 处 理 〈 通 常 进行 转发 或 重 定向 ) 。 例 14-14 演 示 
了 我 们 的 AlbumActionBean.java。 





例 14-14: 专辑 控制 器 : AlbumActionBean.java 





package com.oreilly.hh.web; 




































































import java.util.List; 

import org.apache.log4j.Logger; 

import net.sourceforge.stripes.action.”*; 

import net.sourceforge.stripes.integration.spring.SpringBean; 
import net.sourceforge.stripes.validation.*; 

import com.oreilly.hh.dao.AlbumDAO; 

import com.oreilly.hh.data.Album; 

/** 

*Class that implements the web based front end of our Jukebox. 
* 

*/ 

public class AlbumActionBean implements ActionBean { 

/** 

*Logger 

*/ 


private static Logger 
log=Logger.getLogger (AlbumActionBean.class) ; 








/** 
*The ActionBeanContext provided to this class by Stripes 
DispatcherServlet. 














a 

private ActionBeanContext context; 

/** 

*The list of Album objects we will display on the Album list page. 


ae 
private List<Album>albums; 

/** 

*The Album we are providing a form for on the edit page. 
wf 

private Album album; 

/** 

*The Data Access Object for our Albums. 

xy. 

private AlbumDAO albumDAO; 

public ActionBeanContext getContext () 10 

return context; 

} 

public void setContext (ActionBeanContext aContext) { 
context=aContext; 

} 

/** 

*The default event handler that displays a list of Albums. 
*@return a forward to the Album list jsp. 

xy 

@DefaultHandler 

public Resolution list O {@ 

albums=albumDAO.list () ; © 

return new ForwardResolution ("/albums/list.jsp") ; 

} 

/** 

*The event handler for handling edits to an Album 
*@return a forward to the Album edit jsp. 

*/ 
public Resolution edit © { 

if (album! =null) {@ 

album=albumDAO.get (album.getId O) ) ; 

} 

return new ForwardResolution ("/albums/edit.jsp") ; 
} 

/** 

*The event handler for saving an Album. 

*@return a redirect to the Album list jsp. 

mi 

public Resolution save () { 

albumDAO.persist (album) ; 




























































































log.debug ("Redirecting to list! ") ; 

return new RedirectResolution ("/albums/list.jsp") ; 

} 

/** 

*A getter for the view to retrieve the list of Albums. 

*@return a list of Albums 

ae 

public List<Album>getAlbums () {©@ 

return albums; 

} 

/** 

*A setter for the DispatcherServlet to call that provides the 
album to 

*save. 

*/@param anAlbum 

@ValidateNestedProperties ({@ 

@Validate (field="title", required=true, on={"save"}) , 

@Validate (field="numDiscs", required=true, on={"save"}) 




































































public void setAlbum (Album anAlbum) { 

log.debug ("setAlbum") ; 

album=anAlbum; 

} 

/** 

*A getter for the edit view to call. 

*@return an Album 

* 

public Album getAlbum () { 

return album; 

} 

/** 

*A method Spring will call that provides this class with an 
AlbumDAO 

*instance.@param anAlbumDAO The AlbumDAO object 

*] 

@SpringBean ("albumDAO") @ 

public void injectAlbumDAO (AlbumDAO albumDAO) { 

this.albumDAO=albumDAO; 

} 

} 




















@QActionBean 接 口 惟一 要 求 必 须 实现 的 是 setContext() 和 
getContext () 方法 ，ActionBean 可 以 通过 这 两 个 方法 来 获取 有 关 它 的 操 





作 所 在 的 Stripes 环 境 的 信息 。 


人 @ 这 个 返回 Resolution 的 public 的 方法 在 Stripes 中 称 为 事件 处 理 器 。 
它们 被 自动 绑 定 到 浏览 器 能 够 访问 的 URL 上 。 例 如 ， 对 于 访问 路 


径 /stripesapp/Album.action?save=，Dispatcher 就 会 选中 这 个 方法 。 


全 现在 还 没有 AlbumDao.list() 方法 ， 所 以 我 们 需要 将 它 增 加 到 
AlbumDAO 接 口 〈 其 定义 位 于 第 13 章 ) 和 AlbumHibernateDAO 实 现 类 
中 。 


@@*“ 如 果 专 辑 不 为 null， 那 么 就 加 载 专辑 ”似乎 有 点 逆向 逻辑 的 意 
味 ， 但 是 真正 发 生 的 情况 是 : 当 Stripes 将 请 求 绑 定 到 ActionBean 中 的 对 
象 时 ， 它 看 到 的 只 是 一 个 album.id 参 数 ， 用 这 个 id 值 来 创建 一 个 新 的 
Album 对 象 ， 接 着 再 调用 这 个 方法 。 但 是 我 们 真正 想 知 道 的 是 如 何 从 数 
据 库 中 加 载 一 个 Album 对 象 ， 再 编辑 它 ， 所 以 这 就 是 我 们 在 这 里 所 做 的 
处 理 。 


加 当 在 请 求 中 发 现 表 单数 据 与 bean 属 性 的 命名 模型 匹配 时 ，Stripes 
就 会 调用 ActionBean 中 相应 的 public 类 型 的 getter 和 setter 方 法 。 例 如 ， 当 
请 求 参 数 中 有 album.id、album.title 以 及 album.numDiscs 时 ，Stripes 就 会 
调用 setAlbum〈) 方法 。 另 一 方面 ， 当 加 浏览 器 生成 表单 时 ， 融 会 使 用 
getter 方 法 预 生 成 各 个 值 〈 这 也 就 是 例 14-12 中 的 那些 stripes: text 之 类 的 
标签 所 完成 的 作用 〉。 


@Stripes 提 供 了 验证 标注 ， 用 于 标明 当 调 用 事件 处 理 器 时 应 该 看 到 
哪些 字段 。 我 们 在 此 处 不 准备 深入 介绍 更 详细 的 内 容 ， 你 可 以 在 Stripes 
的 在 线 文 档 ( BI， 中 找到 更 多 的 信息 。 


@SpringBean 标 注 是 告诉 Stripes: 在 Spring 上 下 文中 查找 这 个 对 象 
值 ， 并 插入 到 这 里 。 我 们 在 这 里 没有 使 用 Spring 应 用 程序 中 典型 的 public 
类 型 的 setter 方 法 ， 因 为 黑客 Chacker) 可 能 会 调用 这 样 的 方法 来 正确 地 
格式 化 Web 请求， 出 于 安全 原因 ， 我 们 应 该 防止 类 似 的 访问 。 为 Spring 
HWA C) 的 方法 采用 其 他 命名 规范 ， 通 常 是 个 好 主意 。 





如 前 所 述 ，AlbumDAO 需 要 有 一 个 list O 方法 返回 所 有 的 Album 对 
象 ， 以 及 一 个 get() 方法 根据 专辑 的 id 来 取 回 对 应 的 Album 对 象 。 为 
此 ， 我 们 需要 调整 一 下 AlbumDAO 接 口 和 AlbumHibernateDAO 实 现 。 例 
14-15 演 示 了 更 新 后 的 AlbumDAO.java， 修 改过 的 部 分 以 粗 体 突 出 显示 。 


例 14-15: 在 AlbumDAO 中 增加 list O Mget O 方法 的 定义 





package com.oreilly.hh.dao; 

import java.util.List; 

import com.oreilly.hh.data.Album; 
public interface AlbumDAO{ 

public Album persist (Album album) ; 
public void delete (Album album) ; 
public List<Album>list © ; 

public Album get (Integer id); 

} 



































例 14-16 以 粗 体 突出 显示 了 需要 对 AlbumHibernateDAO.java 进 行 的 修 


改 。 


例 14-16: 在 AlbumHibernateDAO 中 增加 list O 和 get O 方法 的 实 
现 





package com.oreilly.hh.dao.hibernate; 

import java.util.List; 

import 
org.springframework.orm.hibernate3.support.HibernateDaoSupport; 

import com.oreilly.hh.dao.AlbumDAO; 

import com.oreilly.hh.data.Album; 

public class AlbumHibernateDAO extends HibernateDaoSupport 
implements AlbumDAO{ 

public Album persist (Album album) { 

album= (Album) getHibernateTemplate () .merge (album) ; 

getSession () .flush () ; 

return album; 

} 

public void delete (Album album) { 

getHibernateTemplate () .delete (album) ; 

} 

@SuppressWarnings ("unchecked") 

public List<Album>list © { 

return getHibernateTemplate () .loadAll (Album.class) ; 

} 

public Album get (Integer id) { 

return (Album) getHibernateTemplate () .load (Album.class, id) ; 

} 

} 







































































例 14-16 中 使 用 的 是 HibernateTemplate.loadAll() 方法 ， 它 与 


Session.loadAll ©) 的 功能 一 样 ， 将 返回 作为 参数 提供 的 类 的 所 有 持久 
化 对 象 的 列表 。 第 13 章 已 经 讨论 过 使 用 HibernateTemplate 类 的 优点 。 





现在 我 们 已 经 有 了 两 个 视图 ， 一 个 ActionBean， 也 对 DAO 进 行 了 7 相 
应 的 修改 。 接 下 来 就 可 以 编译 和 体验 这 个 Web 应 用 程序 了 。 相 关 命 令 如 








例 14-17 所 示 。 


例 14-17: 编译 我 们 的 Stripes 应 用 程序 





Sant compile 

Buildfile: build.xml 
Overriding previous definition of reference to project.class.path 
prepare: 
compile: 
[javac]Compiling 20 source files to 
/home/rfowler/Hibernate Book/examples/ch12/webapp/WEB 
[copy]Copying 1 file to/home/rfowler/Hibernate 

Book/examples/ch1i2/webapp/ 

EB-INF 

BUILD SUCCESSFUL 

Total time: 2 seconds 






































NF/classes 







































































当 部 署 例 14-5 所 示 的 应 用 程序 时 ， 我 们 将 Context 元 素 的 一 个 属性 设 
置 为 : reloadable=true。 这 样 设 置 以 后 ， 当 为 Web 应 用 程序 的 WEB- 
INF/classes 目 录 提 供 了 新 版 本 的 类 时 ，Tomcat 将 会 自动 重新 加 载 程序 的 
context。 假 设 你 让 Tomcat 仍 然 保 持 运行 ， 如 果 稍 等 片刻 ，context 束 会 自 
动 加 载 完 成 。 在 这 一 处 理 完成 以 后 ， 就 可 以 用 浏览 器 来 访问 
http://localhost: 8080/stripesapp/albums/list.jjsp， 看 到 的 页 面 应 该 如 图 14- 


3 所 示 。 


Mozila Hirefox 


title discs action 





图 143 我 们 的 ActionBean 跑 起 来 了 








现在 我 们 的 数据 库 中 还 没有 数据 ， 所 以 这 个 页 面 也 不 会 显示 任何 专 
辑 信息 。 但 是 点 击 "New" 链 接 ， 将 会 打开 例 14-12 编 写 的 编辑 页 面 ， 如 图 
14-4 所 示 。 


Mozilla Firefox 





LJ http:/localhost:8080/stripesapp/albums/edit jsp | 


Album Edit Page 


Title: | 
Discs:| 


Album Comments 


Please add the album before entering 
comments. 


Save | 


| Done Bog — |B] | Adblock 











图 144 加 载 Edit (编辑 ) AG 


可 以 想象 到 这 个 页 面 的 功能 ， 在 表单 中 输入 有 效 的 数据 ， 操 
击 "Save" 提 交 表 时 后 ， 将 会 把 数据 保存 到 数据 库 中 ， 再 返回 到 列表 视 
图 ， 如 图 14-5 所 示 。 如 果 能 够 按 这 个 流程 走 下 来 的 话 ， 束 表明 你 已 经 成 


功 地 集成 了 Hibernate、Stripes 以 及 Spring! 花 些 时 间 来 思考 一 下 本 章 进 
行 的 数据 库 处 理 。 令 人 激动 的 应 该 是 没有 花费 多 少 代码 就 完成 了 这 么 多 
处 理 。 你 在 AlbumDAO 和 AlbumHibernateDAO 中 添加 了 list © 和 

edit © 两 个 方法 ， 使 用 AlbumDAO 对 象 来 加 载 和 持久 化 Album 对 象 。 
你 也 会 注意 到 ， 整 个 过 程 中 没有 用 任何 代码 来 直接 处 理 
HTTPServletResponse 或 HTTPServletRequest 对 象 一 Stripes 已 经 为 你 处 理 
好 了 这 些 繁琐 的 工作 。 
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File Edit View History Bookmarks Tools Help $ 
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title discs action 
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图 145 显示 了 一 些 内 容 的 列表 视图 


刚才 发 生 了 什么 


到 目前 为 止 ， 我 们 已 经 用 Stripes、Spring 以 及 Hibernate 构 建 好 了 一 
个 简单 的 web 应 用 程序 。 现 在 我 们 可 以 列 出 所 有 的 专辑 、 创 建新 的 专 
辑 、 对 专辑 进行 编辑 。AlbumActionBean 使 用 Stripes 和 第 13 章 写 的 
Hibernate DAO 来 保存 对 象 ， 为 视图 提供 对 象 。 


T PRTA 


既然 我 们 已 经 讨论 了 如 何 实现 基 本 的 插入 、 更 新 、 显 示 数 据 的 处 
理 ， 我 们 就 回 过 头 来 ， 看 看 怎么 在 程序 中 处 理 关 联 。 现 在 我 们 还 根本 没 
有 认真 思考 过 它 。 


[1] http://www.stripesframework.org/display/stripes/Download. 
[2] http://www.sttipesframework.org/display/stripes/Documentation. 
[3] http://www.stripesframework.org/display/stripes/Validation+Reference. 


[4] http://www.stripesframework.org/display/sttipes/Spring+with+ Stripes. 


处 理 关 联 


因为 我 们 的 例子 还 没有 处 理 任 何 关 联 ， 所 以 就 避 开 了 典型 应 用 程序 
中 会 遇 到 的 一 个 复杂 问题 。 其 实 ， 当 DAO 对 象 在 它们 的 persist O 方法 
中 调用 merge() 方法 时 ， 就 会 持久 化 你 发 送 给 它 的 任何 东西 。 如 果 正 
在 持久 化 的 对 象 没有 包含 所 有 与 它 关 联 的 对 象 ， 那 么 就 会 改写 原来 持久 
化 的 数据 ， 而 那些 没有 包含 的 关联 也 会 随 之 丢失 。 例 如 ， 如 果 一 个 专辑 
Album 原 本 有 两 个 评论 ， 但 是 保存 时 使 用 的 是 一 个 空 的 评论 集合 ， 那 么 
以 前 数据 库 中 原 有 的 评论 就 会 丢失 。 我 们 在 这 一 节 就 为 添加 和 编辑 专辑 
的 评论 而 实现 一 个 事件 处 理 器 和 视图 。 只 有 这 样 ， 你 才能 明白 我 们 正在 
解决 的 问题 到 底 是 怎么 回 事 儿 ， 我 们 再 去 讨论 如 何 解决 这 个 问题 。 首 
先 ， 增 加 一 个 editComments.jsp 文 件 ， 其 内 容 如 例 14-18 所 示 ， 它 为 添加 
专辑 评论 提供 相应 的 表单 。 








例 14-18: 评论 编辑 器 : webapp/albums/edit_comment.jsp 








<%@page contentType="text/html; charset=UTF-8"language="java"%s> 
<%@taglib prefix="cC"uri="http://java.sun.com/jsp/jstl/core"s> 
<S@taglib 
prefix="stripes"uri="http://stripes.sourceforge.net/stripes.tld"%> 
<stripes: useActionBean 
beanclass="com.oreilly.hh.web.AlbumActionBean"var= 
"actionBean"event="edit"/> 
<h1l>Add a comment for the album<span style="font-style: 
italic">S{action 
Bean.album.title}</span></h1> 
<stripes: form action="/Album.action"> 
<stripes: hidden name="album.id"/> 





















































Comment: <stripes: text name="comment"/ > 

<br/> 

<stripes: submit name="saveComment"value="Save"/> 
</stripes: form> 











这 个 JSP 文 件 看 起 来 有 点 熟悉 ， 因 为 它 沿用 了 与 例 14-12 同 样 的 模 
式 。 你 可 以 告诉 stripes: form 标 签 ， 这 个 页 面 要 提交 到 我 们 已 经 创建 的 
AlbumActionBean。 由 于 stripes: submit 标 签 的 name 属 性 为 
saveComment， 所 以 我 们 需要 在 AlbumActionBean 中 增加 一 个 public 类 型 
的 saveComment O 方法 ， 它 同样 也 返回 一 个 Resolution。 因 为 stripes: 
text 标 签 的 name 属 性 为 comment， 我 们 也 需要 在 bean 中 创建 
setComment () 和 getComment () 属性 存 取 器 。 例 14-19 演 示 了 
AlbumActionBean.java 中 新 增加 的 这 些 内 容 。 


例 14-19: AlbumActionBean.java 中 为 了 支持 评论 而 新 增加 的 内 容 





*Event handler to save a comment to the Album 
*@return redirect to the edit Album page. 

aif 
public Resolution saveComment () { 
Album a=albumDAO.get (album.getId () ) ; 
a 

a 














.getComments () .add (comment) ; 
lbumDAO.persist (a) ; 

RedirectResolution r=new RedirectResolution ("/albums/edit.jsp") ; 
r.addParameter ("album.id", album.getId () ) ; 
return r; 

} 

/** 

*@return the comment 

Xi. 

public String getComment () { 

return comment; 


} 














/** 

*@param aComment the comment to set 

*/ 

public void setComment (String aComment) 1 
comment=aComment; 


当 重 新 编译 ， 并 使 用 几 下 新 功能 以 后 ， 你 可 能 会 发 现 程序 有 个 非常 
严重 的 bug。 如 果 先 为 某 个 Album 增 加 些 评论 ， 接 着 再 更 新 闻 一 Album 的 
标题 或 唱片 数量 时 ， 你 会 发 现 评 论 不 见 了 。 产 生 这 个 bug 的 原因 是 每 次 
调用 saveAlbum (©) 方法 时 ，Stripes 就 会 创建 一 个 新 的 Album 对 象 ， 我 们 
接着 再 告诉 Hibernate 保 存 这 个 新 对 象 。 这 个 新 对 象 还 没有 评论 ， 但 它 确 
实 有 个 ID， 所 以 Hibernate 会 更 新 持久 化 的 Album， 让 它 没有 评论 。 





保存 共有 关联 的 对 象 ， 可 以 用 两 种 方法 。 一 种 是 将 inverse 标 志 设 置 
为 tue， 这 样 当 更 新 对 象 时 ， 对 关联 所 做 的 任何 修改 都 将 被 忽略 。 不 
过 ， 这 种 方法 对 专辑 评论 没有 效果 ， 因 为 评论 只 是 我 们 的 模型 中 的 字符 
串 ， 并 不 是 完整 的 实体 ， 所 以 在 评论 对 象 上 没有 setAlbum O 之 类 的 方 
法 可 以 调用 。 男 一 种 解决 这 个 问题 的 方法 是 在 Stripes 调 用 bean 上 的 任何 
setter 存 取 霹 方法 之 前 ， 就 真正 从 数据 库 中 加 载 这 个 对 象 以 及 它 所 关联 的 
所 有 对 象 。 这 样 ， 在 Stripes 开 始 修改 这 个 对 象 以 前 ， 关 联 的 对 象 已 经 生 
成 好 了 。 这 种 方法 听 起 来 很 不 错 ， 我 们 试 一 试 。 











也 应 该 思考 一 下 Stripes 处 理 请 求 的 生命 周期 。Stripes Lifecycle 
Documentation (''!) 详细 解释 了 各 个 阶段 发 生 的 事情 ， 如 果 你 渴望 研 


究 额 外 的 信息 ， 参 考 这 些 文档 就 可 以 。 简 单 来 说 ， 在 解析 好 事件 处 理 器 
NA 
的 各 setter 方 法 。Stripes 提 供 了 一 种 “拦截 器 ”(interceptor) 机 制 ， 通 过 这 
种 机 制 ， 我 们 可 以 在 BindingAndValidation 运 行 以 前 插入 我 们 自己 的 处 理 
代码 。 


拦截 器 : 扩展 Stripes 的 强大 方法 


为 了 告诉 我 们 的 拦截 需 在 什么 时 候 运 行 ， 可 以 在 我 们 的 ActionBean 
中 创建 自己 的 标注 。 这 样 ， 我 们 的 扩展 就 很 自然 地 集成 到 Stripes 的 其 他 
工作 方式 中 。 


一 些 人 不 赞成 使 用 拦截 器 和 面向 切面 的 编程 (Aspect Oriented 
Programming, AOP) ， 因 为 调试 AOP 软 件 一 般 都 很 困难 。 在 一 些 AOP 应 
用 程序 中 ， 很 难 确定 正在 运行 什么 代码 和 代码 运行 的 时 间 。 不 过 ， 随 着 
一 些 新 功能 的 出 现 ， 如 Java 5 标注 ， 用 自 文档 化 《〈self-documenting) 的 
方法 就 可 能 做 更 多 的 事情 (而 不 用 依赖 非 语言 的 窍门 )》， 所 以 我 鼓励 你 
对 Stripes 的 拦截 器 实现 保持 开放 的 思想 。 事 实 上 ，Stripes 和 Spring 都 非 
常 有 效 地 利用 了 这 种 方法 。Stripes 使 用 的 拦截 器 模式 会 检查 ActionBean 
中 的 某 些 标注 ， 并 基于 那些 标注 而 采取 一 定 的 行动 。 采 用 这 种 方法 ， 
Stripes 也 可 以 文 持 基于 Spring 的 依赖 注入 ， 还 可 以 在 适当 的 生命 周期 阶 
段 调用 特定 的 ActionBean 方 法 。 按 照 这 种 模式 来 增加 我 们 自己 的 功能 








相当 简单 ， 所 以 我 们 打算 在 绑 定 和 验证 阶段 之 前 增加 一 种 用 于 加 载 数 据 
bean 的 机 制 。 





如 果 你 以 前 还 没有 写 过 标注 ， 对 它 的 语法 可 能 会 觉得 有 些 陌生 ， 但 
思想 是 相当 直观 的 。 例 14-20 中 的 代码 是 说 ， 开 发 人 员 将 能 够 用 
@LoadBean 标 注 来 标记 方法 ， ne ae iid 
要 加 载 的 成 员 的 名 称 〔 标 注 本 喘 并 不 提供 这 些 语 义 ， 它 只 是 支持 这 种 语 
法 。 我 们 在 例 14-22 中 演示 的 Interceptor 代 码 就 使 用 该 标注 来 实现 想 要 的 
功能 ) 。 例 14-20 演 示 了 我 们 的 新 标注 ， 应 该 将 它 保存 为 


LoadBean.java。 











例 14-20: 创建 LoadBean 标 注 





package com.oreilly.hh.web; 

import java.lang.annotation.”*; 

/** 

*An annotation used to mark methods with a bean to load. 
* 


*@author Ryan Fowler 





@Retention (RetentionPolicy.RUNTIME) @ 
@Target ({ElementType.METHOD}) @ 
@Documented® 

public@interface LoadBean{@ 

/** 

*The name of the bean to load. 

六 次 

String value O; O 

} 



































@ 这 个 标注 中 的 @RetentionPolicy 取 值 为 RunTime， 这 是 在 告诉 





Java， 在 编译 生成 的 类 中 保存 标注 信息 ， 以 便 我 们 的 拦截 器 
(Interceptor) 在 运行 时 能 够 看 到 它们 。 对 ， 在 编写 标注 类 时 也 可 以 使 
用 很 多 其 他 标注 。 








@@Target 标 注 用 于 指定 LoadBean 标 注 应 该 应 用 到 什么 类 型 的 元 
素 。 当 运行 特定 的 ActionBean 事 件 处 理 器 时 ， 我 们 的 拦截 器 束 会 检查 标 
注 。 由 于 事件 处 理 器 是 ActionBean 中 的 方法 ， 所 以 这 里 的 目标 类 型 设置 
为 ElementType.METHOD。 


@@Documented 标 注 指 定 应 该 用 JavaDoc 来 文档 化 LoadBean 标 注 。 


介面 对 @interface 这 样 的 说 明 符 ， 标 注定 义 语法 让 人 乍 看 起 来 感觉 
很 不 安 。 在 Java 中 增加 新 的 功能 的 愿望 与 日 俱 增 , 但 是 却 没有 增加 新 的 
关键 字 ， 这 样 就 导致 了 在 定义 标注 时 还 得 重用 interface 关 键 字 。 要 是 这 
两 种 需求 能 够 从 撤 术 上 得 以 很 好 地 解决 ， 标 注定 义 的 可 读 性 也 就 不 会 受 
到 什么 影响 了 。 








Ovalue O 方法 的 定义 只 是 规定 这 个 标注 只 有 一 个 参数 ， 该 参数 的 
名 称 是 value。 之 所 以 要 使 用 value 作 为 参数 名 称 ， 原 因 是 这 样 可 以 使 用 
简写 形式 的 @LoadBean ("memberName") ， 而 不 必 使 用 稍微 长 些 的 
@LoadBean (value="memberName") 。 这 是 标注 机 制 本 身 支持 的 一 种 


规范 。 


现在 ， 我 们 可 以 在 AlbumActionBean 中 相关 的 事件 处 理 器 上 应 用 这 





个 标注 ， 以 告诉 拦截 器 它 需 要 做 什么 。@LoadBean 标 注 稍 后 会 告诉 我 们 
的 拦截 器 在 Stripes 调 用 Album 上 的 setter 方 法 之 前 加 载 Album bean. 


例 14-21: 新 的 AlbumActionBean.save () 事件 处 理 器 








*The event handler for saving an Album. 
*@return a redirect to the Album list jsp. 











@LoadBean ("album") 

public Resolution save () { 

albumDAO.persist (album) ; 

log.debug ("Redirecting to list! ") ; 

return new RedirectResolution ("/albums/list.jsp") ; 











OK， 这 一 切 听 起 来 都 相当 不 错 ， 但 是 神奇 的 拦截 器 的 工作 原理 是 
怎么 样 的 ? 为 了 加 载 那个 Album bean， 我 们 需要 某 个 东西 ， 它 应 该 在 
BindingAndValidation 阶 段 之 前 运行 ， 这 样 才 能 加 载 数 据 。 前 面 我 们 提 
到 ，Stripes 提 供 了 一 种 拦截 器 执行 功能 ， 这 正 是 我 们 需要 的 钩子 

(hook) 。 为 了 使 用 这 个 功能 ， 我 们 得 编写 一 个 实现 Stripes Interceptor 
接口 的 类 ， 再 用 StripesFilter 的 init-param 告 诉 Stripes 要 使 用 这 个 拦截 器 。 
在 这 个 拦截 器 类 中 用 @Intercepts 标 注 可 以 告诉 Stripes 它 对 什么 生命 周期 
阶段 感 兴趣 ， 在 那些 执行 点 上 就 会 调用 实现 的 intercept() 方法 。 


在 我 们 的 intercept() 方法 中 ， 会 在 事件 处 理 占 中 检查 @LoadBean 
标注 。 如 果 那 个 标注 存在 ， 就 用 Spring 和 Hibernate 和 党 试 加 载 那个 标注 的 





value 属 性 指定 的 名 称 所 对 应 的 对 象 。 这 一 步 完 成 以 后 ， 通 过 调用 
ExecutionContext.proceed O 和 它 的 返回 值 ， 拦 截 器 融会 指示 Spring 接 
下 来 继续 要 做 什么 事情 。 例 14-22 演 示 了 LoadObjectInterceptor.java 的 源 


代码 。 


例 14-22: 对 象 加 载 拦 截 器 





package com.oreilly.hh 


.web; 





import 








import 


import 
import net.sourceforge 
import net.sourceforge 














import net.sourceforge. 
import net.sourceforge. 





























import org.apache.log4j.Logger; 
t org.springframework.orm. 


java.lang.reflect.Method; 


javax.servlet.http.HttpServletRequest; 





hibernate3.HibernateTemplate; 





.stripes. 
.stripes. 


action.Resolution; 
controller.*; 

















stripes 








@Intercepts ({Lifecycl 








SpringInterceptorSupport 











implements Interceptor { 





stripes. 
-util.bean. 
Stage. BindingAndVal 
public class LoadObjectl] 


integration.spring.*; 


HibernateTemplate hibernateTemplate; 


private Logger 


log=Logger.getLogger (LoadObject] 








BeanUtil; 





lidation}) @ 


[Interceptor extends 


Interceptor.class) ; 


public Resolution intercept (ExecutionContext ctx) throws 








Exception{@ 





Method handler=ctx.getHand] 
LoadBean loadProperty=handl 
if (loadProperty! =nul1& &loadProperty.value () ! ="" 














ler () ; 
ler.getAnnotation (LoadBean.class) ; 





HttpServletRequest 











& & loadProperty.value () ! =null) {@ 
String propertyName=loadProperty.value () ; 
String idName=propertyName+".id"; 


© 





request=ctx.getActionBeanContext () .getRequest (); @ 











Class<?>propertyClass= 











Object o=hibernateTemp] 














String idValue=request.getParameter (idName) ; 





BeanUtil.getPropertyType (propertyName, ctx.getActionBean ()); O 
if CidValue! =null& &idValue! ="") { 


late.get (propertyClass, 


Integer.valueOf (idValue) ); @ 











BeanUtil.setPropertyVal 


ue (propertyName; 





ctx.getActionBean () , 

propertyClass.cast (o) ); © 

} 

} 

Resolution resolution=ctx.proceed (); © 

return resolution; 

} 

@SpringBean ("hibernateTemplate") 四 

public void injectHibernateTemplate (HibernateTemplate 
aHibernateTemplate) { 

this. hibernateTemplate=aHibernateTemplate; 

} 

} 




















@Stripes 已 经 知道 这 个 类 要 成 为 一 个 Interceptor， 因 为 在 web.xml 中 
己 经 列 出 了 相关 的 配置 。 不 过 ， 它 的 @Intercepts 标 注 还 告诉 Stripes， 这 
个 特殊 的 拦截 器 类 将 拦截 哪个 生命 周期 阶段 。 





@intercept O 方法 就 是 在 我 们 感 兴趣 的 生命 周期 阶段 将 要 调用 的 
方法 。 在 这 个 方法 中 ， 我 们 想 加 载 数 据 。 需 要 做 的 第 一 件 事 是 找到 
Spring 已 经 选择 的 事件 处 理 嚣 ， 以 便 可 以 查找 我 们 的 @LoadBean 标 注 。 
Spring 让 这 些 操作 变 得 很 简单 ， 通 过 ExecutionContext.get-Handler () 方 
法 就 可 以 返回 代表 事件 处 理 器 的 Method 对 象 。 














OlJava 5 的 标注 机 制 可 以 很 好 地 对 反射 (reflection〉 提供 扩 展 支 
持 ， 我 们 只 要 简单 地 调用 Method.getAnnotation O ， 就 可 以 找到 事件 处 
理 器 方法 中 的 @LoadBean 标 注 〈 如 果 确 实 存在 ) 。 


四 如 果 没 有 找到 请 求 类 型 的 标注 ，getAnnotation O 方法 就 返回 
nul， 上 所 以 Interceptor 要 检查 是 否 找到 了 @LoadBean 标 注 ， 以 及 它 的 值 是 


否 中 以 让 Hibernate 能 够 继续 加 载 数 据 。LoadBean.value O 方法 返回 原 
来 附加 到 事件 处 理 器 标注 上 的 参数 。 在 例 14-21 中 ， 将 propertyName 的 取 
值 设 置 为 了 album。 


没有 谈 及 的 一 个 命名 规范 是 ， 我 们 一 直 将 数据 bean 的 id 属 性 命名 为 
id。 从 Stripes 构 建 请 求 参 数 的 方法 来 看 ， 这 意味 着 只 要 简单 地 将 字符 
捉 ".id" 附 加 到 通过 @LoadBean 标 注 找到 的 bean 名 称 的 后 面 ， 束 能 够 构造 
出 包含 想 要 加 载 的 bean 的 ID 属性 值 的 参数 。 在 例 14-21 中 ， 相 关 的 请 求 


参数 是 album.id。 


人 @ 我 们 已 经 知道 了 想 要 加 载 的 请 求 参数 的 名 称 ， 这 样 就 能 够 在 请 求 
参数 中 查找 这 个 参数 ， 这 是 通过 


ExecutionContext.getActionBeanContext () .getRequest © 来 完成 的 。 


@ 在 拦截 器 使 用 Spring 的 HibemateTemplate 加 载 数 据 对 象 之 前 ， 还 
需要 知道 试图 加 载 的 对 象 是 什么 类 型 的 。Stripes 提 供 了 一 个 名 为 
BeanUtil 的 实用 工具 类 来 处 理 bean， 以 便 简化 这 种 与 bean 交 互 的 操作 。 
BeanUtil.getPropertyType O 返回 一 个 Class 对 象 ， 准 确 地 告诉 我 们 需要 
知道 的 一 切 。 





@ 装 备 好 了 我 们 想 要 加 载 对 象 的 ID 和 类 型 ， 就 可 以 让 Hibernate 完 成 
加 载 了 。 只 需要 将 这 些 参数 传递 给 HibernateTemplate.get O 方法 ， 即 可 
加 载 我 们 想 要 的 数据 。 注 意 ， 这 个 Interceptor 完 全 是 通用 的 ， 它 不 需要 


特定 类 型 的 DAO， 能 够 在 任何 在 使 用 这 些 框架 的 应 用 程序 中 ， 处 理 任何 
绑 定 到 Hibernate 映 射 对 象 上 的 数据 bean。 


@BeanUtil 也 提供 了 一 个 setPropertyValue() 方法 ， 可 以 为 数据 对 
象 的 属性 进行 赋值 。 在 这 里 需要 将 从 Hibernate 返 回 的 数据 对 象 的 类 型 转 
换 为 前 面 已 经 准备 好 的 类 型 ， 人 否则 调用 ActionBean 上 的 setter 方 法 将 会 失 
败 。 


@ExecutionContext.proceed O 方法 返回 一 个 Resolution 实 例 ， 将 


Stripes 指 向 下 一 件 要 做 的 事 的 链接 。 


加 就 像 ActionBean 中 的 一 样 ， 从 SpringInterceptorSupport 继 承 的 类 能 
够 通过 Spring 的 依赖 注入 来 实例 化 。 在 这 个 例子 中 ， 我 们 从 Spring 中 获 


取 HibernateTemplate 类 。 





现在 需要 让 Stripes 知 道 它 应 该 运行 刚才 创建 的 
LoadObjectInterceptor。 为 了 提供 Spring bean 注 入 ， 我 们 已 经 在 web.xml 
中 配置 好 了 SpringInterceptor。 将 LoadObjectInterceptor 放 在 
Interceptor.Classes init-param 的 SpringInterceptor 和 


BeforeAfterMethodInterceptor 条 目 之 间 ， 如 例 14-23 所 示 。 


例 14-23: 在 web.xml 中 将 我 们 的 Interceptor 添 加 到 StripesFilter 





<filter> 








<display-name>Stripes Filter</display-name> 
<filter-name>StripesFilter</filter-name> 
<filter-class> 
net.sourceforge.stripes.controller.StripesFilter 
</filter-class> 

<init-param> 
<param-name>ActionResolver.PackageFilters</param-name> 
<param-value>com.oreilly.*</param-value> 

</init-param> 

<init-param> 
<param-name>ActionResolver.UrlFilters</param-name> 
<param-value >WEB-INF/classes</param-value> 

</init-param> 

<init-param> 

<param-name>Interceptor.Classes</param-name> 

<param-value> 
net.sourceforge.stripes.integration.spring.SpringInterceptor, 
com.oreilly.hh.web.LoadObjectInterceptor, 
net.sourceforge.stripes.controller.BeforeAfterMethodInterceptor 
</param-value> 

</init-param> 

</filter> 























































































































在 前 面 的 第 13 章 中 ，DAO 对 象 可 以 继承 HibernateDAOSupport， 但 
我 们 这 里 的 LoadObject-Interceptor 不 能 这 样 做 。 为 了 使 用 依赖 注入 ， 它 
现在 需要 继承 Stripes 的 SpringInterceptorSupport。 为 此 ， 我 们 在 





LoadObjectInterceptor 中 添加 了 一 个 injectHibernateTemplate〈() 方法 ， 还 
要 在 applicationContext.xml 中 用 id hibernateTemplate 定 义 一 个 


HibernateTemplate bean， 如 例 14-24 所 示 。 


例 14-24: 在 applicationContext.xml 中 为 我 们 的 Interceptor 注 入 


HibernateTemplate 











id="hibernateTemplate"class="org.springframework.orm.hibernate3. 
HibernateTemplate"> 
<property name="sessionFactory"> 
<ref bean="sessionFactory"/> 
</property> 
<property name="cacheQueries"> 
<value>true</value> 
</property> 
</bean> 




















再 次 运行 ant compile, Tomcat 应 该 重新 加 载 context， 这 时 应 用 程序 就 
应 该 可 以 正确 处 理 前 面 我 们 无 法 解决 的 专辑 评论 的 问题 了 。 在 调用 
AlbumActionBean 的 Save 事件 处 理 器 以 前 ， 会 先 调用 
LoadObjectInterceptor.intercept () 方法 。 因 为 在 
AlbumActionBean.save O 方法 上 有 一 个 @LoadBean 标 注 ， 
LoadObjectInterceptor 束 会 尝试 用 请 求 参数 album.id 所 代表 的 id 来 加 载 
Album 对 象 。 如 果 这 种 方法 正常 运行 ， 当 Stripes 开 始 调 用 Album 上 的 
setter 方 法 时 ， 关 联 数 据 应 该 就 已 经 在 Album 中 了 。 所 以 ， 再 调用 
persist () 方法 时 ， 关 联 数据 就 不 会 丢失 了 。 


这 个 例子 让 人 感 兴趣 的 部 分 是 它 演示 了 如 何 扩展 Stripes 的 功能 ， 这 
是 非常 简洁 的 一 所 有 功能 都 在 幕后 运行 ， 用 简单 、 紧 凑 的 标注 来 触及 它 
们 。 





我 们 已 经 演示 了 一 种 集成 Hibernate 和 Stripes 的 方法 。Stripes 带 来 的 
实用 的 功能 、 先 进 的 编码 技术 、 适 度 的 扩展 点 ， 这 些 让 它 成 为 一 个 使 用 
起 来 令 人 感到 愉快 的 Web 框 架 。 大 多 数 Web 应 用 程序 都 需要 某 种 持久 化 


机 制 ，Hibernate 的 ORM 功 能 与 Stripes 的 自动 对 象 生 成 机 制 的 组 合成 就 了 
一 种 功能 更 为 强大 的 工具 。 编 写 项 目 不 再 只 是 退 求 可 以 用 什么 组 件 ， 而 
是 讲究 怎么 让 集成 可 以 更 光滑 ， 怎 么 能 让 各 个 组 件 更 好 地 彼此 适应 ( 尤 
其 是 用 Spring 集成 各 组 件 ) 。 











你 可 以 将 本 章 研 究 的 一 些 技术 应 用 到 其 他 Java 项 目 。 使 用 拦截 露 来 
检查 正在 处 理 的 类 中 保存 的 元 数据 标注 ， 这 种 技术 对 于 为 我 们 的 应 用 程 
序 中 增加 安全 保护 之 类 的 功能 特别 有 用 。 





[1] http://stripesframework.org/display/stripes/Lifecycles+Ete. 


附录 A Hibernate 类 型 





按照 数据 与 持久 化 服务 关系 的 不 同 ， 而 对 两 种 不 同 的 数据 进行 了 基 
本 的 区 分 : 实体 和 值 。 


实体 有 它 自 己 独 立 的 存在 ， 而 不 考虑 当前 在 Java 虚 拟 机 中 是 否 有 任 
何 对 象 引 用 了 它 。 通 过 查询 可 以 从 数据 库 中 检索 回 实体 ， 它 们 必须 由 应 
用 程序 显 式 地 保存 和 删除 (如 果 已 经 建立 了 级 联 关系 ， 对 父 实体 的 保存 
或 删除 动作 也 会 触发 它 的 子 对 象 的 保存 或 删除 。 但 从 父 实 体 的 角度 来 
看 ， 这 种 级 联 仍然 是 显 式 的 ) 。 





值 只 是 保存 为 实体 的 持久 化 状态 的 一 部 分 。 它 们 没有 自己 的 独立 存 
在 。 值 可 以 是 原始 类 型 、 集 合 或 者 用 户 目 定义 的 类 型 。 因 为 它们 完全 从 
属于 赖 以 存在 的 实体 ， 所 以 它们 不 能 被 独立 地 加 上 版 本 信息 ， 也 不 能 被 
多 个 实体 或 集合 共 至 。 


注意 ， 东 个 特定 的 Java 对 象 既 可 能 是 实体 ， 也 可 能 是 值 。 区 别 在 于 
它 的 设计 方式 ， 以 及 它 是 如 何 提 供给 持久 化 服务 的 。 原 始 Java 类 型 总 是 
值 。 


基本 值 类 型 


这 里 只 是 简单 地 列举 了 一 些 有 关内 建 类 型 的 信息 ， 演 示 了 它们 怎么 
将 Java 类 关联 到 SQL 的 字段 类 型 。 我 们 提供 了 数据 库 之 间 存 在 着 的 差异 
的 例子 ， 但 不 打算 列举 每 种 差异 。 有 关 权 威 性 的 细节 描述 ， 可 以 查看 
org.hibernate.dialect 中 所 有 数据 库 方言 实现 的 源 代码 (查找 register- 
ColumnType () 调用 ) 。 





Hibernate 的 基本 类 型 可 以 大 致 分 为 : 
简单 数字 和 Boolean 类 型 


这 些 类 型 都 对 应 于 Java 的 原始 类 型 ， 可 以 代表 数字 、 字 符 、Boolean 
值 或 者 其 封装 类 型 ， 它 们 要 映射 到 适当 的 SQL 字段 类 型 〈 基 于 使 用 的 
SQL 方言 ) 。 这 些 类 型 是 : boolean、byte、character、double、float、 
integer、long、short、true_false 以 及 yes_no。 最 后 两 种 类 型 是 Boolean 值 
在 数据 库 中 的 另外 两 种 表示 形式 ，true_false 使 用 "T" 和 "FE" 值 ， 而 yes_no 
则 使 用 "Y" 和 "N" 值 。 








Hibernate 类 型 string 可 以 将 java.lang.String 映 射 到 与 SQL 方言 相应 的 
字符 串 字 段 类 型 (通常 是 VARCHAR， 或 者 是 Oracle 的 VARCHAR2) 。 





Hibernate Hdate. time timestamp, java.util.Date (及 其 子 
K) 映射 到 相应 的 SQL 类 型 (例如 DATE、TIME、TIMESTAMP) . 
timestamp 实 现 使 用 的 是 Java 环 境 中 的 当前 时 间 ; 除了 使 用 dbtimestamp， 
你 也 可 以 使 用 数据 库 对 当前 时 间 的 符号 表示 方法 。 如 果 你 比较 喜欢 使 用 
更 方便 的 java.util.Calendar 类 ， 在 编写 自己 的 代码 时 也 不 需要 将 它 和 Date 
类 型 的 值 来 回转 换 ， 你 可 以 用 calendar (这 个 类 型 将 日 期 和 时 间 保 存 为 
TIMESTAMP) 或 calendar_date〈 这 个 类 型 只 接受 日 期 部 分 ， 映 射 为 
DATE 字 段 类 型 ) 直接 进行 映射 。 


任意 精度 的 数字 类 型 


Hibernate 的 big_decimal 类 型 提供 从 java.math.BigDecimal 到 相应 的 
SQL 类 型 之 间 的 映射 〈 通 常 是 NUMERIC， 但 Oracle 使 用 NUMBER) 。 
Hibernate 的 big_integer 提 供 对 java.math.BigInteger 的 映射 (通常 映射 到 
BIGINT， 但 Informix 称 之 为 INT8，Oracle 则 再 次 使 用 NUMBER) 。 


本 地 化 值 


Hibernate 类 型 locale、timezone 以 及 currency 保 存 为 字符 串 
(VARCHAR 或 VARCHAR2) ， 并 被 映射 到 java.util 包 中 的 Locale、 
TimeZone 以 及 Currency 类 。Locale 和 Currency 的 实例 用 它们 的 ISO 代 码 进 
行 保 存 ， 而 TimeZone 则 用 它 的 ID 属性 进行 保存 。 


Class% #5 


Hibernate 的 class 类 型 将 java.lang.Class 的 实例 映射 为 它 的 完全 限定 的 
名 称 ， 保 存在 字符 串 类 型 的 字段 中 (VARCHAR， 或 者 Oracle 中 的 
VARCHAR?) 。 


字 节 数组 


binary 类 型 将 字 节 数组 (byte array) 上 映射 为 对 应 的 SQL 二 进 制 类 
型 。 可 序列 化 对 象 serializable 类 型 用 于 将 可 序列 化 的 Java 类 型 映射 到 对 
应 的 SQL 二 进 制 类 型 。 这 是 一 种 后 备 类 型 ， 当 一 个 对 象 没 有 更 合适 的 特 
定 持久 化 映射 时 《而 且 也 不 想 为 它 实现 一 个 UserType 自 定义 映射 ， 参 见 
BOW) ， 就 可 以 党 试 使 用 这 种 类 型 。 该 类 型 映射 到 的 SQL 类 型 与 
binary 的 映射 类 型 相同 ， 稍 后 将 加 以 介绍 。 


JDBC 大 型 数据 对 象 


blob 和 clob 类 型 为 java.sql 包 中 的 Blob 和 Clob 类 提供 映射 。 如 果 你 正 
在 处 理 真 正 的 大 型 数据 对 象 ， 最 好 是 将 这 些 属性 声明 为 Blob 或 Clob， 即 
便 这 样 会 在 数据 对 象 中 需要 增加 一 个 显 式 的 JDBC 依 赖 。 通 过 Hibernate 
可 以 方便 地 利用 JDBC 的 功能 来 延迟 加 载 属性 值 ， 只 有 在 需要 的 时 候 才 
加 载 这 些 大 型 数据 对 象 。 








如 果 你 不 担心 数据 的 体积 太 庞大 ， 就 可 以 不 必 使 用 这 种 直接 的 


JDBC 接 口 ， 只 要 将 属性 类 型 声明 为 String 或 byte[]， 再 将 它 用 text 或 
binary 进 行 映 射 。 这 些 类 型 分 别 对 应 于 SQL 类 型 的 CLOB 和 
VARBINARY (在 Oracle 中 是 RAW， 在 PostgreSQL 中 则 是 BYTEA) . “4 
加 载 对 象 时 ， 也 会 立即 将 这 些 值 加 载 到 各 个 属性 中 。 


目 定 义 值 类 型 


除了 将 对 象 映射 为 实体 ， 也 可 以 创建 目 定 义 的 类 ， 将 它们 映射 为 数 
据 库 中 其 他 实体 的 值 ， 而 不 能 自己 独立 存在 。 实 现 这 种 上 映射， 简单 的 
话 ， 只 要 改变 现 有 类 型 的 映射 方式 就 可 以 了 【可 能 你 想 使 用 一 种 不 同 的 
字段 类 型 或 表示 方式 ) ; 复杂 的 话 ， 就 需要 将 一 个 值 划 分 到 多 个 字段 


中 。 














虽然 在 映射 文档 中 可 以 在 个 别 的 基础 上 ， 一 个 个 地 来 实现 映射 ， 但 
为 了 遵循 尽 可 能 避免 代码 重复 的 原则 ， 应 该 将 要 在 多 处 使 用 的 类 型 封装 
到 一 个 真正 可 重用 的 类 中 。 自 定义 的 类 可 以 实现 org.hibernate.UserType 
或 org.hibernate.CompositeUserType 接 口 。 第 6 章 对 这 种 技术 进行 了 介 


绍 。 


用 这 种 方法 可 以 对 Java 5 的 enum 〈 枚 举 ) 类 型 (以 及 旧版 本 的 Java 
中 ， 手 工 编码 的 类 型 安全 的 枚 举 模式 的 实例 ) 进行 映射 。 可 以 用 一 种 单 
独 的 、 可 重用 的 自 定 义 类 型 映射 来 支持 所 有 的 枚 举 类 型 ， 如 第 6 章 所 


最 后 介绍 一 种 非常 目 由 的 映射 。 本 质 上 ， 这 种 类 型 的 映射 可 以 将 引 
用 交 蔡 映射 到 其 他 多 种 映射 实体 。 它 需要 提供 两 个 字段 ， 第 一 个 字段 包 
含 每 个 引用 被 映射 到 的 表 的 名 称 ， 另 一 个 字段 则 提供 关注 的 特定 实体 在 
那个 表 中 的 ID。 


在 这 种 松散 的 映射 关系 中 ， 不 能 指定 任何 外 键 约 束 。 其 实 ， 现 实 中 
很 少 需要 这 种 类 型 的 映射 。 可 能 需要 使 用 这 种 映射 的 一 种 情况 是 ， 如 果 
尔 想 维护 一 个 审计 日 志 ， 它 可 能 包含 多 种 实际 的 对 象 。 参 考 手 册 中 也 提 
及 Web 应 用 程序 的 会 话 数 据 也 是 为 一 种 潜在 的 使 用 情况 ， 但 古 这 样 的 程 
序 似乎 不 可 能 是 一 种 结构 民 好 的 应 用 程 友 。 


Ss 


所 有 类 型 


以 下 表格 列举 了 org.hibernate.types 包 中 支持 的 所 有 类 型 ， 以 及 在 映 
财 文 档 中 应 该 使 用 的 类 型 名 称 、 映 射 值 在 保存 时 可 能 使 用 的 最 常见 的 
SQL 类 型 、 有 关 类 型 作用 的 相关 注释 。 对 于 许多 映射 情况 ， 前 面 已 经 做 
了 更 详细 的 介绍 。 除 了 由 其 他 所 有 类型 实现 的 Type 接口 ， 为 了 节省 页 面 
空间 ， 每 种 类 型 名 称 后 面 的 “类 型 ”(Type) 一 词 就 省 略 掉 了 。 


类 型 


AbstractBynary 
(或 许 也 可 以 指 
byte/binary/array? ) 
AbstractCharArray 
AbstractComponent 
(接口 ) 

Abstract 

Any 

Array 

Association 〈 接 口 ) 
Bag 

BigDecimal 
BigInteger 

Binary 

Blob 

Boolean 

Byte 

CalendarDate 
Calendar 

Character 
CharacterArray 


CharArray 


类 型 名 称 


N/A 


N/A 
N/A 


N/A 

any 

array 

N/A 

bag 
big_decimal 
big_integer 
binary 

blob 
boolean 
byte 
calendar_date 
calendar 
character 
N/A 

N/A 


SQL 类 型 


N/A 


N/A 
N/A 


N/A 

N/A 

N/A 

N/A 

N/A 
NUMERIC 
BIGINT 
VARBINARY 
BLOB 

BIT 
TINYINT 
DATE 
TIMESTAMP 
CHAR 
VARCHAR 
VARCHAR 


注释 
封装 用 于 将 字 节 流 绑 定 到 VARBINARY- 风 格 的 字段 类 型 的 代码 





封装 用 于 将 字符 流 绑 定 到 VARCHAR- 风 格 的 字段 类 型 的 代码 
让 Component 类 型 可 以 保存 集合 、 级 联 等 


内 建 类 型 使 用 的 抽象 框架 

支持 “any” 类 型 映射 

将 Java 数 组 映射 为 持久 化 集合 

支持 实体 间 的 关联 

用 bag 语 义 对 集合 进行 映射 

在 Oracle 中 ， 对 应 的 SQL 类 型 是 NUMBER 

在 Oracle 中 ， 对 应 的 SQL 类 型 是 NUMBER; Informix 则 使 用 INT8 
字 节 数组 的 基本 类 型 ， 非 延迟 加 载 〈 详 细 参 阅 本 附录 ) 
链接 到 JDBC， 支 持 延 迟 加 载 的 字 节 数组 

基本 原始 类 型 

映射 Calendar， 忽 略 时 间 

映射 Calendar， 包 括 时 间 

一 种 基本 的 原始 类 型 

映射 Character[ ] 属性 

映射 char[ ] 属性 


类 型 


CharBoolean 


Class 


Clob 

Collection 
Component 
CompositeCustom 


Currency 


Custom 

Date 

DbTimestamp 
Discriminator (接口 ) 


Double 


EmbeddedComponent 


Entity 

Float 

Identifier (#11) 
IdentifierBag 


类 型 名 称 


N/A 


class 


clob 
N/A 
component 
N/A 


currency 


N/A 
date 
dbtimestamp 


N/A 


double 
composite - 
element 
N/A 

float 

id 

idbag 


SQL 类 型 


CHAR 
VARCHAR 或 
VARCHAR2 
CLOB 

N/A 

N/A 

N/A 
VARCHAREK 
VARCHAR2 
N/A 

DATE 
TIMESTAMP 
N/A 


DOUBLE 
N/A 


N/A 
FLOAT 
N/A 
N/A 


E) 
注释 
用 于 实现 yes_no 和 true_false 类 型 的 抽象 框架 
用 于 存储 类 名 称 的 基本 类 型 


链接 到 JDBC， 支 持 延 迟 加 载 的 字符 数组 

支持 所 有 的 持久 化 集合 类 型 

将 包含 的 值 类 的 各 属性 映射 到 一 组 字段 

调整 CompositeUserType 的 实现 ， 以 支持 一 定 的 Type 接口 


为 Currency 存 储 其 ISO 

代码 

调整 UserType 的 实现 ， 以 支持 一 定 的 Type 接口 
基本 原始 类 型 


基本 原始 类 型 ， 使 用 数据 库 表示 的 “now?” 

为 用 于 实现 鉴别 器 〈discriminator) 属性 的 类 型 标识 其 接口 
(选择 正确 的 映射 子 类 ) 

基本 原始 类 型 

在 映射 内 声明 特定 的 ComponentType 


表示 到 另 一 个 实体 的 引用 
为 用 于 保存 实体 的 标识 符 的 类 型 标记 其 接口 
用 bag 语 义 映射 一 个 Collection 及 其 标识 符 字段 





Immutable 
Integer 

List 

Literal (接口 ) 


Locale 


Long 
ManyToOne 
Map 

Meta 
Mutable 
Nullable 
OneToOne 
OrderedMap 
OrderedSet 
Primitive 


Serializable 


Set 
Short 
SortedMap 


SortedSet 


N/A 
integer 
list 
N/A 


locale 


long 
many-to-one 
map 
meta-type 
N/A 

N/A 
one-to-one 
N/A 

N/A 

N/A 


serializable 


set 
short 
N/A 
N/A 


N/A 
INTEGER 
N/A 
N/A 


VARCHAR 或 
VARCHAR2 
LONG 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

Binary (see JDBC 
Large Objects earlier) 
N/A 

SMALLINT 

N/A 

N/A 


恒定 类 型 Cimmutable type) 的 抽象 超 类 ; 扩展 NullableType 
基本 原始 类 型 

映射 Java 的 List 

为 用 于 保存 SQL 字 面值 

(literal》 的 类 型 而 标识 其 接口 

为 locale (HHE) 保存 其 ISO 代码 


基本 原始 类 型 

实体 之 间 的 一 种 关联 

映射 Java 的 Map 

为 使 用 any 的 多 态 映 射 保存 其 鉴别 器 (discriminator ) 的 值 
非 恒定 类 型 (mutable type) 的 抽象 超 类 

简单 的 、 可 以 为 null 的 字段 类 型 的 抽象 超 类 
实体 之 间 的 一 种 关联 

MapType 的 扩展 ， 以 保留 SQL 排序 

SetType 的 扩展 ， 以 保留 SQL 排序 

用 于 映射 原始 Java 类 型 的 抽象 框架 ; 扩展 了 ImmutableType 
可 序列 化 类 没有 更 好 的 映射 选择 时 ， 可 以 用 这 种 映射 


映射 Java 的 Set 
MapType 的 扩展 ， 以 利用 Java 的 有 序 集合 
SetType 的 扩展 ， 以 利用 Java 的 有 序 集合 


CGE) 

















类 型 类 型 名 称 SQL 类 型 TERE 
String string VARCHAR or 基本 原始 类 型 

VARCHAR2 
Text text CLOB 将 CLOB 字 段 以 非 延迟 方式 加 载 到 一 个 String 类 型 的 属性 中 《参见 

上 述说 明 ) 

Time time TIME 基本 原始 类 型 
TimeZone timezone VARCHAR or 保存 时 区 ID 

VARCHAR2 
Timestamp timestamp TIMESTAMP 基本 原始 类 型 ， 使 用 JVM 表 示 的 “now” 
TrueFalse true_false CHAR 将 Boolean 值 保存 为 “T” 或 者 “F” 
Type (HO) N/A N/A 所 有 类 型 的 超级 接口 (superinterface) 
Version (接口 ) N/A N/A 为 版 本 惟 Cversion stamp) 而 扩展 Type 
WrapperBinary N/A N/A 这 个 类 型 好 像 还 没有 定义 好 
YesNo yes_no CHAR 将 Boolean 值 保存 为 “Y” 或 “N” 








还 有 一 个 TypeFactory 类 ， 在 为 给 定 的 需要 而 构建 正确 的 Type 实 现时 ， 可 以 用 它 来 提供 帮助 ， 例 如 ， 在 映射 文档 中 解析 一 个 类 
型 名 称 时 。 阅 读 一 下 它 的 源 代码 也 很 有 趣 。 











附录 B Criteria API 


Criteria 查 询 首先 使 用 createCriteria O 方法 从 Session 中 获取 一 个 
Criteria 对 象 ， 并 标明 执行 查询 的 对 象 〈 主 要 的 类 ， 也 就 是 数据 表 ) 。 之 
后 再 通过 下 面 介绍 的 各 种 工厂 方法 为 Criteria 附 加 上 约束 条 件 、 投 影 以 及 
排序 ， 这 样 它 就 可 以 成 为 一 个 功能 非常 强大 而 方便 的 查询 接口 了 。 





Criterion L) — 


Restrictions 可 以 作为 创建 Criterion 实 例 的 工厂 ， 用 于 限制 从 条 件 查 
询 中 返回 的 对 象 〈 记 录 行 ) 。Restrictions 定 义 了 一 组 静态 方法 ， 通 过 调 
用 这 些 方法 并 传递 一 定 的 参数 ， 就 可 以 方便 地 创建 在 Hibernate 中 使 用 的 
标准 Criterion 实 现 。 这 些 碍 询 条 件 用 于 诀 定 在 查询 结果 中 最 终 包 含 哪些 
来 自 数据 库 的 持久 化 对 象 。 下 表 总 结 了 Restrictions 工 三方 法 可 以 提供 的 
选择 。 





DI 


allEq 


and 


between 


conjunction 


Map properties 


Criterion lhs, 


Criterion rhs 


String property, 


Object low, 
Object high 
m 


目的 


让 多 个 属性 的 取 值 为 特定 值 的 快捷 方式 。Map 对 象 中 的 键 
是 需要 加 以 限制 的 属性 的 名 称 ， 而 Map 中 的 相应 值 则 是 每 
个 属性 必须 等 于 的 目标 取 值 《如 果 某 个 实体 要 包含 在 查询 
结果 中 的 话 )。 返 回 的 Criterion 可 以 确保 每 个 指定 的 属性 都 
有 具有 相应 的 取 值 

创建 一 个 组 合 Criterion， 只 有 当 它 的 两 个 Criterion 代 表 的 条 
件 都 满足 时 ， 整 个 条 件 才 满 足 。 也 可 以 参阅 conjunction( ) 

要 求 指 定 属 性 的 取 值 应 该 落 在 参数 1ow 和 

high 指 定 的 值 的 范围 内 














创建 一 个 Conjunction 对 象 ， 可 以 用 它 来 创建 任意 数目 的 
“and” 关 系 的 查询 条 件 。 只 需要 简单 地 调用 它 的 add( ) 方 法 ， 





方法 


disjunction 


eq 


eqProperty 


ge 


geProperty 


gt 


gtProperty 


idEq 
ilike 


ilike 


String property, 
Object value 
String property 1, 
String property2 
String property, 
Object value 
String property 1, 
String property2 
String property, 
Object value 
String property|, 
String property2 
Object value 
String property, 
Object value 
String property, 
String value, 
MatchMode mode 


( 续 ) 
目的 


并 提供 需要 检查 的 每 个 Criterion 实 例 。 当 且 仅 当 Conjunction 
中 的 每 个 子 查询 组 件 都 为 tue 时 ，Conjunction 才 为 true。 与 使 
用 and( ) 方 法 来 手工 构建 查询 条 件 的 树 状 结构 相 比 ， 
Conjunction 更 方便 一 些 。Criteria 接 口 的 add( ) 方 法 看 起 来 表 
明 它 内 部 也 包含 了 一 个 Conjunction 

创建 一 个 Disjunction 对 象 ， 可 以 用 它 来 创建 任意 数目 的 
“or” 关 系 的 查询 条 件 。 只 需要 简单 地 调用 它 的 add( ) 方 法 ， 
并 提供 需要 检查 的 每 个 Criterion 实 例 。 如 果 Disjunction 中 的 
任何 一 个 子 查询 组 件 为 true，Disjunction 就 为 true。 与 使 用 
or( ) 方 法 来 手工 构建 查询 条 件 的 树 状 结构 相 比 ，Disjunction 
更 方便 一 些 。 相 关 示 例 可 以 参阅 例 8-10 

要 求 指定 属性 具有 特定 的 值 


要 求 两 个 指定 属性 的 取 值 相同 


要 求 指定 属性 的 值 大 于 或 等 于 指定 的 值 


要 求 第 一 个 指定 的 属性 的 取 值 大 于 或 等 于 第 二 个 属性 的 取 值 


要 求 指 定 属 性 的 取 值 大 于 特定 的 值 


要 求 第 一 个 指定 属性 的 取 值 大 于 第 二 个 属性 的 取 值 


要 求 标识 符 (identifier〉 属性 等 于 指定 的 值 
大 小 写 不 敏感 的 “like” 运 算 符 ， 参 见 “]ike” 


大 小 写 不 敏感 的 “like” 运 算 符 ， 供 不 喜欢 复杂 的 “like” 
语法 ， 只 需要 匹配 一 定 的 子 字符 串 的 用 户 使 用 。MatchMode 
是 一 个 类 型 安全 的 枚 举 值 ， 可 选取 的 值 为 START、END、 
ANYWHERE 以 及 EXACT。 这 个 方法 会 根据 mode 属 性 指 
定 的 匹配 模式 来 调整 value 的 语法 结构 ， 接 着 再 像 两 个 参数 
的 ilike( ) 方 法 那样 进行 处 理 


方法 


isEmpty 
isNotEmpty 
isNotNull 
isNull 

le 


leProperty 


like 


like 


ItProperty 


naturalld 


ne 


neProperty 


not 


参数 


String property， 


Collection values 


String property, 
Object[] values 


String property 
String property 
String property 
String property 
String property, 
Object value 
String property|, 
String property2 
String property, 
Object value 


String property, 
String value, 
MatchMode mode 
String property, 
Object value 
String property |, 
String property2 


None 


String property, 
Object value 
String property|, 
String property2 


Criterion expression 


( 续 ) 
目的 


要 求 指定 的 属性 取 值 可 以 选取 集合 中 包含 的 任意 值 。 与 手 
工 建立 eq( ) 查 询 条 件 的 disjunction( ) 方 法 相 比 ， 这 个 方法 更 
方便 

要 求 指定 的 属性 取 值 可 以 选取 数组 中 包含 的 任意 值 。 与 手 
工 建立 eq( ) 查 询 条 件 的 disjunction( ) 方 法 相 比 ， 这 个 方法 更 
方便 

要 求 指定 的 集合 属性 是 空 的 《成 员 个 数 为 0) 

要 求 指定 的 集合 属性 至 少 要 有 一 个 元 素 

要 求 指定 的 属性 不 能 包含 null 值 

要 求 指定 的 属性 为 null 

要 求 指定 的 属性 小 于 或 等 于 特定 的 值 。 参 见 例 8-3 


要 求 指定 的 第 1 个 属性 小 于 或 等 于 第 2 个 属性 


要 求 指定 的 属性 “like” 于 特定 的 值 (从 SQL like 运 算 符 的 
意义 上 来 说 ， 它 支持 简单 的 子 字 符 串 匹配 )。 参 见 例 8-8 和 
例 8-16 

为 不 喜欢 复杂 的 “like ”运算 符 语法 ， 只 想 匹 配 一 定 的 子 字 
符 串 的 人 提供 的 “like ”运算 符 。 更 多 细节 请 参阅 ilike( ) 
方法 

要 求 指定 的 属性 小 于 特定 的 值 


要 求 指定 的 第 1 个 属性 小 于 第 2 个 属性 

支持 通过 <natural-id> 了 映射 的 多 列 “ 自 然 业务 键 ”(Cnatural 
business key) 的 选择 

要 求 指定 的 属性 不 能 取 特 定 的 值 


要 求 指定 的 两 个 属性 具有 不 同 的 值 


对 给 定 的 Criterion 求 反 (如 果 Criterion 匹 配 ， 则 为 false， 反 
之 亦 然 ) 


方法 


OT 


sizeEq 


sizeGe 


sizeGt 


sizeLe 


sizeLt 


sizeNe 


sqlRestriction 


sqlRestriction 


sqlRestriction 


参数 


Criterion lhs, 


Criterion rhs 


String property, 


int size 


String property, 


int size 


String property, 


int size 


String property, 


int size 


String property, 


int size 


String property, 


int size 


String sql 


String sql, 


Object[] values, 


Type[] types 
String sql, 
Object value, 
Type type 


目的 

构建 一 个 复合 Criterion， 只 要 它 的 任意 一 个 子 Criterion 匹 配 ， 
则 该 复合 条 件 就 成 功 。 参 见 disjunction( ) 

要 求 指定 的 集合 属性 具有 特定 数量 的 子 元 素 


要 求 指定 的 集合 属性 至 少 包含 一 个 特定 的 元 素 


要 求 指定 的 集合 属性 的 成 员 个 数 大 于 特定 的 值 


要 求 指定 的 集合 属性 的 成 员 个 数 不 超 过 特定 的 值 


要 求 指定 的 集合 属性 的 成 员 个 数 少 于 特定 的 值 


要 求 指 定 的 集合 属性 中 互 不 相同 的 成 员 的 个 数 超过 size 
采用 底层 数据 库 系统 的 原生 SQL 方言 来 表达 限制 条 件 。 虽 
然 这 个 功能 强大 ， 但 要 小 心 因此 而 失去 可 移植 性 的 意义 
采用 底层 数据 库 系 统 的 原生 SQL 及 多 个 JDBC 参 数 来 表达 限 
制 条 件 。 虽 然 这 个 功能 强大 ， 但 要 小 心 因此 而 失去 可 移植 
性 的 意义 
采用 底层 数据 库 系 统 的 原生 SQL 及 JDBC 参 数 来 表达 限制 条 
件 。 虽 然 这 个 功能 强大 ， 但 要 小 心 因此 而 失去 可 移植 性 的 


当 为 sqlRestriction O 方法 指定 查询 语句 文本 时 ， 碍 询 语句 中 出 现 
的 任何 "{alias}" 字 符 串 都 将 由 执行 查询 涉及 的 数据 表 的 实际 别名 所 取 


Ko 


这 些 方法 中 的 多 数 都 以 Criterion 实 例 作 为 参数 ， 可 以 按照 你 人 
任意 复杂 程度 来 构建 复合 条 件 查 询 树 。 


需要 的 





过 conjunction() 和 


disjunction ©) 返回 的 对 象 可 以 方便 地 添加 新 的 查询 条 件 ， 多 次 调用 
add O 方法 可 以 添加 任意 多 个 条 件 。 不 过 ， 如 果 但 询 足 够 复 森 的 话 ， 
用 HQL 进 行 查 询 可 能 更 容易 表达 和 理解 。 还 有 小 量 的 查询 种 类 用 这 种 
API 无 法 提供 支持 ， 所 以 不 可 能 总 能 避免 使 用 HQL。 但 是 这 种 情况 会 越 
来 越 少 ， 大 多 数 这 类 基本 的 查询 在 应 用 程序 开发 的 整个 过 程 中 都 会 用 
到 ， 而 用 这 种 API 来 表达 简单 的 查询 也 非常 自然 和 容易 ， 同 时 也 让 Java 
代码 变 得 更 加 可 读 和 简洁 ， 并 在 编译 时 就 检查 代码 是 否 正确 。 














Projection L] — 


Hibernate 提 供 的 org.hibernate.criterion.Projections 可 以 作为 创建 投影 
实例 的 工厂 ， 用 投影 可 以 缩小 从 条 件 查询 中 返回 的 属性 〈 列 ) 的 个 数 ， 
以 及 计算 聚合 (aggregate) 值 。 可 以 调用 投影 类 提供 的 静态 方法 ， 并 使 
用 提供 的 参数 来 方便 地 创建 Hibernate 中 使 用 的 标准 投影 实现 。 这 些 投影 
用 于 缩小 查询 结果 中 属性 的 范围 、 对 属性 进行 分 组 或 转换 。 以 下 列举 了 
Hibernate 提 供 的 一 些 可 用 选项 。 


方法 

alias 

avg 

count 
countDistinct 
distinct 
groupProperty 
id 

max 


min 


projectionList 


property 
rowCount 


sqlGroupProjection 


sqlProjection 


sum 


参数 


Projection projection, 


String alias 

String property 
String property 
String property 


Projection projection 


String property 


None 


String property 
String property 


None 


String property 
None 

String sql, String 
groupBy, String[] 
columnAliases, 
Type[] types 
String sql, String[] 
columnAliases, 
Type[] types 
String property 


目的 
为 投影 指派 一 个 别名 《名称 )， 以 便 在 Criteria 查 询 


的 其 他 地 方 可 以 引用 该 投影 〈 例 如 分 组 、 排 序 等 ) 
计算 指定 属性 的 平均 值 
计算 在 结果 中 指定 属性 出 现 的 次 数 


计算 在 结果 中 取 值 不 相同 的 指定 属性 出 现 的 次 数 
让 投影 查询 只 返回 具有 惟一 值 的 记录 “〈 去 掉 取 值 重 
复 的 记录 ) 

按 指定 的 属性 对 查询 结果 进行 分 组 (可 与 聚合 值 计 
算 一 起 使 用 )。 参 见 例 8-15 

将 对 象 的 标识 符 作为 投影 的 一 个 元 素 ( 不 论 标识 符 
属性 的 名 称 是 什么 ) 

计算 指定 属性 的 最 大 值 。 参 见 例 8-15 

计算 指定 属性 的 最 小 值 


创建 一 个 新 的 投影 列表 ， 用 于 请 求 多 个 投影 值 。 参 
见 例 8-14 

在 投影 中 包括 指定 的 属性 。 参 见 例 8-13 

计算 返回 结果 中 的 记录 行 的 个 数 。 参 见 8-15 
支持 使 用 数据 库 特 定 的 SQL 代 码 来 执行 投影 ; 
groupBy 可 以 包含 一 个 SQL “GROUP BY” 子 句 。 
这 里 需要 告诉 Hibernate 投 影 中 返回 列 的 别名 和 类 型 


支持 使 用 数据 库 特定 的 SQL 代 码 来 执行 投影 ， 可 以 
使 用 上 面 的 groupProperty( ) 投 影 来 执行 分 组 。 这 里 
需要 告诉 Hibernate 投 影 中 返回 列 的 别名 和 类 型 


计算 指定 属性 值 的 代数 和 


Order LJ ~ 


可 以 让 Hibernate《〈 它 再 让 底层 的 数据 库 系统 ) 对 查询 结果 按 一 定 的 
顺序 进行 排序 。org.hibernate.criterion.Order 类 代表 这 些 排序 请 求 ， 提 供 
了 两 个 静态 工厂 方法 用 于 创建 实例 ， 再 将 这 些 实例 附加 到 条 件 查 询 中 。 
在 获得 Order 实 例 后 ， 如 果 需 要 让 结果 排序 不 区 分 字母 大 小 写 ， 则 可 以 
调用 Order 实 例 上 的 非 静 态 方 法 ignoreCase () 。 





方法 参数 目的 
asc String property 按照 指定 属性 的 升序 排列 对 结果 进行 排序 。 参 见 例 8-6 








desc String property 按照 指定 属性 的 降序 排列 对 结果 进行 排序 


Property L) 


在 目前 介绍 的 方法 中 ， 都 是 先 按 照 感 兴趣 的 内 容 来 创建 条 件 查 询 、 
投影 或 者 排序 实例 ， 再 将 查询 涉及 的 属性 名 称 作为 参数 传递 给 相关 方 
法 。Criteria API 也 支持 用 与 上 述 相反 的 方向 来 进行 处 理 ， 先 从 属性 开 
台 ， 再 调用 一 个 方法 来 构建 基于 该 属性 的 查询 或 投影 。 
org.hibernate.criterion.Property 是 一 个 创建 Property 实 例 的 工厂 ， 如 果 你 喜 
欢 后 面 这 种 构建 查询 的 方法 ， 就 可 以 使 用 这 个 类 。Property 定 义 了 一 个 
静态 的 forName O 方法 ， 调 用 它 就 可 以 创建 一 个 代表 特定 属性 的 实 
例 。 在 获得 实例 以 后 ， 就 可 以 再 调用 该 实例 提供 的 方法 来 创建 基于 它 代 
表 的 属性 上 的 条 件 查询 、 投 影 以 及 排序 。 本 书 这 里 只 列举 一 些 经 常 使 用 
到 的 方法 ， 省 略 介 绍 的 方法 主要 与 离线 查询 〈detached criteria) 和子 查 
询 有 关 ， 这 些 主题 已 经 超出 本 书 的 范围 。 当 你 需要 了 解 它 们 时 ， 可 以 看 
Æ (Java Persistence with Hibernate》 中 的 "Advanced query options" (高 
级 查询 选项 ) 这 一 章 ， 或 是 在 线 参考 文档 中 的 "Detached queries and 
subqueries" (H1) (离线 查询 和 子 查 询 ) 这 一 部 分 。 














Ti, 


asc 


avg 


between 


count 


None 


Object min, 


Object max 


None 


目的 

创建 一 个 Order， 根 据 指定 属性 值 的 升序 顺序 对 查询 
结果 进行 排序 

创建 一 个 Projection， 返 回 属性 值 的 平均 值 
创建 一 个 Criterion， 要 求 属性 值 介 于 min 和 max 之 间 

















创建 一 个 Projection， 返 回 属性 值 在 查询 结果 中 出 现 的 


ea 


方法 


desc 


eq 
eqProperty 


eqProperty 


ge 
geProperty 


geProperty 


getProperty 


group 


gt 
gtProperty 


gtProperty 


isEmpty 


isNotEmpty 


isNotNull 


isNull 


le 


参数 


None 


Object value 
Property other 


String property 


Object value 


Property other 


String property 


String property 


None 


Object value 


Property other 


String Property 


Collection values 


Object[] values 


None 


None 


None 


None 


Object value 


( 续 ) 


目的 
创建 一 个 Order， 根 据 指定 属性 值 的 降序 顺序 对 查询 
结果 进行 排序 


创建 一 个 Criterion， 要 求 属性 值 等 于 提供 的 值 2 
创建 一 个 Criterion， 要 求 属 性 值 等 于 另 一 个 由 other 代 
表 的 属性 值 

创建 一 个 Criterion， 要 求 属 性 值 等 于 另 一 个 其 名 称 由 
property 指 定 的 属性 值 

创建 一 个 Criterion， 要 求 属性 值 大 于 或 等 于 指定 的 值 2 
创建 一 个 Criterion， 要 求 属性 值 大 于 或 等 于 另 一 个 由 
other 代 表 的 属性 值 

创建 一 个 Criterion， 要 求 属性 值 大 于 或 等 于 另 一 个 其 
名 称 由 property 指 定 的 属性 值 

从 当前 属性 中 提取 指定 名 称 的 复合 属性 元 素 〈 假 定 当 
前 属性 是 一 个 复合 属性 )。 返 回 另 一 个 Property 实 例 
创建 一 个 Projection， 要 求 按 当前 属性 值 对 查询 结果 进 
行 分 组 

创建 一 个 Criterion， 要 求 属性 值 大 于 指定 的 值 2 
创建 一 个 Criterion， 要 求 属 性 值 大 于 另 一 个 由 other 代 


表 的 属性 值 
创建 一 个 Criterion ， 要 求 属 性 值 大 于 另 一 个 其 名 称 由 
property 指 定 的 属性 值 


创建 一 个 Criterion， 要 求 属性 值 包含 于 提供 的 集合 中 
创建 一 个 Criterion， 要 求 属性 值 应 该 等 于 提供 的 数组 


中 的 某 个 元 素 

创建 一 个 Criterion， 要 求 属性 应 该 为 空 (包含 0 个 元 素 
的 集合 ) 

创建 一 个 Criterion， 要 求 属性 应 该 为 至 少 包含 一 个 元 
素 的 集合 


创建 一 个 Criterion， 要 求 属 性 值 不 能 为 null 
创建 一 个 Criterion， 要 求 属性 值 为 null 
创建 一 个 Criterion， 要 求 属性 值 小 于 或 等 于 指定 的 值 2 


方法 


leProperty 


leProperty 


like 


like 


It 
ItProperty 


ItProperty 


ne 


neProperty 


neProperty 


参数 


Property other 


String property 


Object value 


String value， 


MatchMode mode 


Object value 


Property other 
String property 
None 

None 

Object value 


Property other 


String property 


( 续 ) 


目的 
创建 一 个 Criterion， 要 求 属性 值 小 于 或 等 于 另 一 个 由 
other 代 表 的 属性 值 


创建 一 个 Criterion， 要 求 属性 值 小 于 或 等 于 另 一 个 其 
名 称 由 property 指 定 的 属性 值 

创建 一 个 Criterion， 要 求 属性 值 “like” 于 指定 的 值 
(从 SQL like 运 算 符 的 意义 来 说 ， 它 支持 简单 的 子 字 符 
RACAL) © 

供 不 喜 欢 复 杂 的 “like” 语 法 ， 只 需要 匹配 一 定 的 子 
字符 串 的 用 户 使 用 的 “1like” 方 法 。MatchMode 是 一 
个 类 型 安全 的 枚 举 值 ， 可 选取 的 值 为 START、END、 
ANYWHERE 以 及 EXACT。 这 个 方法 会 根据 mode 属 
性 指定 的 匹配 模式 来 调整 value 的 语法 结构 ， 接 着 再 像 
一 个 参数 的 like( ) 方 法 那样 进行 处 理 2 
创建 一 个 Criterion， 要 求 属性 值 小 于 指定 的 值 2 

创建 一 个 Criterion， 要 求 属性 值 小 于 另 一 个 由 other 代 


表 的 属性 值 
创建 一 个 Criterion ， 要 求 属 性 值 小 于 另 一 个 其 名 称 由 
property 指 定 的 属性 值 


创建 一 个 Projection， 返 回 当前 属性 的 最 大 值 
创建 一 个 Projection， 返 回 当前 属性 的 最 小 值 
创建 一 个 Criterion， 要 求 属 性 值 不 能 取 指 定 的 值 2 
创建 一 个 Criterion， 要 求 属性 值 不 能 等 于 男 一 个 由 
other 代 表 的 属性 值 

创建 一 个 Criterion， 要 求 属性 值 不 能 等 于 男 一 个 其 名 
称 由 property 指 定 的 属性 值 


注 : O 该 方法 的 返回 类 (CountProjection) 有 一 个 setDistinct( ) 方 法 ， 如 果 需 要 统计 不 同属 性 值 的 个 数 ， 
则 可 以 调用 这 个 方法 。 

© 该 方法 的 返回 类 (SimpleExpression) 有 一 个 ignoreCase( ) 方 法 ， 如 果 需 要 进行 不 区 分 大 小 写 的 
比较 ， 则 可 以 调用 这 个 方法 。 


[1] 
http://www.hibernate.org/hib_docs/v3/reference/en/html/querycriteria.html# 


detachedqueries. 


附录 C Hibernate SQL 方言 


掌握 流利 的 SQL 方 言 


Hibernate 封 装 了 对 很 多 商业 1) 和 免费 的 关系 数据 库 的 支持 。 虽 
然 不 进行 这 些 配置 ， 大 多 数 功 能 也 都 可 以 正常 运行 ， 但 是 将 
hibernate.dialect 配 置 属性 设置 成 正确 的 org.hibernate.dialect.Dialect 子 类 具 
有 一 定 的 重要 性 ， 尤 其 是 在 使 用 诸如 native 或 sequence 主 键 生 成 以 及 会 话 





锁定 的 功能 时 。 如 果 你 指定 一 种 方言 ，Hibernate 将 为 一 些 配置 参数 使 用 
合理 的 默认 值 ， 为 你 省 去 了 手工 单独 指定 它们 的 肤 烦 。 


数据 库 系 统 


Caché 2007.1 
DB2 

DB2 AS/400 
DB2 OS390 
Derby 
Firebird 
FrontBase 
H2 
HSQLDB 
Informix 
Ingres 


Interbase 


相应 的 hibernate.dialect 设 置 


org.hibernate.dialect.Cache71Dialect 
org.hibernate.dialect.DB2Dialect 
org.hibernate.dialect.DB2400Dialect 
org.hibernate.dialect.DB2390Dialect 
org.hibernate.dialect.DerbyDialect 
org.hibernate.dialect.FirebirdDialect 
org.hibernate.dialect.FrontbaseDialect 
org.hibernate.dialect.H2Dialect 
org.hibernate.dialect. HSQLDialect 
org .hibernate.dialect.Informix Dialect 
org.hibernate.dialect.IngresDialect 


org.hibernate.dialect.InterbaseDialect 


JDataStore 

Mckoi SQL 

Mimer SQL 

Microsoft SQL Server 

MySQL (versions prior to 5.x) 

MySQL (version 5.x and later) 

MySQL (prior to 5.x, using InnoDB tables) 
MySQL (prior to 5.x, using MyISAM tables) 
MySQL (version 5.x, using InnoDB tables) 
Oracle (any version) 

Oracle 8i 

Oracle 9i or 10g 

Oracle 10g only (use of ANSI join syntax) 
Pointbase 

PostgreSQL 

Progress 

SAP DB 

Sybase (or MS SQL Server) 

Sybase 11.9.2 

Sybase Anywhere 

Teradata 

TimesTen 5.1 

Unisys 2200 RDMS 


( 续 ) 
相应 的 hibernate.dialect 设 置 


org. hibernate.dialect.JDataStore 
org.hibernate.dialect.MckoiDialect 
org.hibernate.dialect.MimerSQLDialect 
org.hibernate.dialect.SQLServerDialect 
org.hibernate.dialect.MySQLDialect 
org.hibernate.dialect.MySQLSDialect 
org.hibernate.dialect. MySQLInnoDBDialect 
org.hibernate.dialect MySQLMyISAMDialect 
org.hibernate.dialect.MySQLSInnoDBDialect 
org.hibernate.dialect.OracleDialect 
org.hibernate.dialect.Oracle8iDialect 
org.hibernate.dialect.Oracle9Dialect 
org.hibernate.dialect.Oracle10gDialect 
org.hibernate.dialect.PointbaseDialect 
org.hibernate.dialect.PostgreSQLDialect 
org.hibernate.dialect.ProgressDialect 
org.hibernate.dialect.SAPDBDialect 
org.hibernate.dialect.SybaseDialect 
org.hibernate.dialect.Sybase1 1 Dialect 
org.hibernate.dialect.SybaseAnywhereDialect 
org.hibernate.dialect.TeradataDialect 
org.hibernate.dialect.TimesTenDialect 


org. hibernate.dialect. RDMSOS2200Dialect 


如 果 以 上 没有 你 需要 的 目标 数据 库 ， 可 以 检查 一 下 最 新 发 布 的 
Hibernate 是 侣 已 经 提供 了 相关 的 文 持 。Hibernate 参 考 文档 的 "SQL 
Dialects" (1) 部 分 列 出 了 能 够 支持 的 大 部 分 SQL 方言 。 如 果 还 是 不 
行 ， 可 以 再 看 看 是 否 能 够 找到 其 他 第 三 方 对 相关 数据 库 的 支持 ， 或 者 考 


虑 上 自己 动手 开发 ! 


[1] 我 从 来 就 没有 指望 可 以 再 次 利用 到 缓存 中 的 东西 ， 还 是 把 软件 健壮 
性 的 问题 留 给 Javar 巴 ……: 
[2] http://www.hibernate.org/hib-docs/v3/reference/en/html/session- 


configuration.html#configuration-optional-dialects. 


附录 D Spring 事 务 支持 


使 用 Spring Framework 的 事务 标注 





在 有 具体 的 类 或 者 接口 上 可 以 添加 Transactional 标 注 ， 为 类 或 方法 增 
加 事务 管理 。 如 果 用 Transactional 对 一 个 类 进行 标注 ， 其 设置 将 会 应 用 
到 类 中 定义 的 每 个 方法 。 如 果 用 Transactional 对 一 个 方法 进行 标注 ， 事 
务 设置 将 只 应 用 到 某 个 单独 的 方法 。 如 果 对 类 和 方法 都 是 应 用 了 
Transactional 标 注 ， 对 方法 进行 的 标注 比 对 类 进行 的 标注 具有 更 高 的 优 
FEAL 0 








通过 Transactional 标 注 ， 可 以 控制 事务 的 隔离 级 别 、 超 时 时 间 、 传 
播 (propagation) 设置 以 及 会 导 仅 事务 回 深 的 一 组 异常 。 例 如 ， 如 果 我 
们 希望 总 是 用 可 序列 化 的 隔离 级 别 创建 一 个 新 的 事务 ， 在 一 分 钟 之 内 没 





有 完成 或 发 生 了 NumberFormatException 异 常 ， 就 回 滚 事务 ， 就 可 以 编 
写 类 似 例 D-1 所 示 的 代码 。 


例 D-1: 更 多 的 事务 配置 控制 选项 





@Transactional (readOnly=false, 
propagation=Propagation.REQUIRES NEW, 
isolation=Isolation.SERIALIZABLE, 
rollbackFor={NumberFormatException.class}, 
timeout=60 ) 


public abstract void run () ; 






























































二 一 


如 采 使 用 Transactional 标 注 ， 需 要 小 心 选 择 标注 放置 的 位 置 。 如 采 
先 使 用 了 Spring 中 的 代理 ， 或 者 准备 要 研究 一 下 Spring 中 为 Aspect- 
Oriented Programming (AOP) 提供 的 引 人 注 目的 文 持 ， 你 需要 注意 尽 





可 能 避免 把 Transactional 标 注 放 到 接口 上 ， 还 需要 注意 要 将 Transactional 
标注 放 在 非 public 的 方法 上 。 在 这 个 示例 中 ， 因 为 我 们 没有 使 用 任何 
Spring 的 AOP 功 能 ， 所 以 就 把 Transactional 标 注 放 在 了 一 个 接口 上 。 如 果 
你 正在 为 一 个 系统 调试 错误 ， 其 中 省 略 了 Transactional 标 注 ， 这 时 需要 
做 的 第 一 件 事 情 就 是 验证 标注 过 的 方法 是 否 是 public 的 。 如 果 使 用 
AspectJ 或 早期 的 Spring AOP 功 能 ， 在 使 用 代理 或 AOP 时 ， 总 会 遇 到 些 令 
人 混淆 的 问题 。 如 果 决 定 使 用 Spring 的 AOP 功 能 ， 就 应 该 记得 务必 将 
@Transactional 标 注 放 在 具体 的 类 上 。 








TER: 如 果 对 这 些 术语 不 熟悉 ， 看 看 下 面 表 格 的 解释 会 有 帮助 。 


Transactional 标 注 属 性 


表 D-1 列 举 了 Transactional 标 注 的 属性 。 


表 D-1: Transactional 标 注 的 属性 


#2D-1: Transactional 标 注 的 属性 


isolation Isolation 事务 隔离 设置 。 后 面 的 表 D-3 提 供 了 可 用 选 
项 的 更 多 细节 

noRollbackFor Class[] 一 组 不 会 导致 事务 回 滚 的 异常 类 (REZ). 

noRollbackForClassName String[] 可 以 指定 一 组 完全 限定 的 类 名 或 Class 对 象 

propagation Propagation 事务 传播 配置 。 有 关 这 一 配置 的 更 多 细节 ， 
可 以 参见 表 D-2 

readOnly boolean 指定 事务 是 只 读 的 ， 还 是 可 读 写 的 

rollbackFor Class[] 一 组 将 会 导致 事务 回 滚 的 异常 类 〔〈 或 类 名 )。 

rollbackForClassName String[] RuntimeExceptions 的 默认 行为 就 是 会 触发 回 


深 ， 而 对 于 checked exception 则 通常 不 会 触 
发 回 深 。 如 果 抛 出 了 checked exception， 并 
希望 因此 而 触发 回 深 ， 就 需要 把 这 个 异常 添 
加 到 rollbackFor 属 性 。 可 以 指定 一 组 完全 限 
定 的 类 名 或 Class 对 象 

timeout int 事务 超时 需要 经 过 的 秒 数 。 如 果 将 这 个 属性 
设置 为 - 1， 则 表示 事务 永远 不 会 超时 (无 
限 的 超时 时 间 ) 


事务 传播 


propagation 属 性 用 于 告诉 Spring， 操 作 是 否 需要 一 个 新 的 事务 、 舰 
套 事务 或 者 还 是 在 现 有 的 事务 中 进行 操作 。 表 D-2 列 出 了 propagation 属 
性 的 有 效 取 值 。 





事务 的 传播 行为 依赖 于 事务 提供 者 。 如 果 你 正在 使 用 的 是 JTA， 
定 要 仔细 阅读 文档 ， 看 看 是 否 文 持 验 套 事务 。 








#D-2: Propagation #2 (i 
值 


Propagation.REQUIRED 
Propagation.SUPPORTS 
Propagation. MANDATORY 
Propagation. REQUIRES_NEW 


Propagation. NOT_SUPPORTED 


Propagation. NEVER 
Propagation. NESTED 


描述 


使 用 现 有 的 事务 ， 如 果 没 有 任何 事务 ， 就 创建 一 个 新 事务 
(这 是 默认 值 ) 

将 参与 到 现 有 的 事务 中 ; 如 果 不 存在 已 有 的 事务 ， 也 不 会 
创建 新 事务 

需要 提供 一 个 现 有 的 事务 ， 如 果 不 存在 现 有 的 ， 则 抛 出 异常 
为 这 个 方法 创建 一 个 新 事务 ， 如 果 存 在 ， 则 挂 起 当前 事务 
标注 方法 中 的 持久 化 操作 将 不 在 事务 中 执行 。 如 果 在 已 经 
有 的 事务 中 调用 该 方法 ， 则 该 事务 会 被 挂 起 

如 果 在 一 个 事务 当中 调用 该 方法 ， 则 抛 出 异常 

如 果 在 一 个 现 有 的 事务 中 调用 该 方法 ， 则 在 骨 套 事务 中 执 
行 该 标注 方法 














isolation 属 性 可 以 控制 在 事务 中 需要 什么 锁 ， 以 及 数据 库 中 当前 正 
在 执行 的 事务 和 状态 对 事务 的 影响 。 表 D-3 列 举 了 isolation 属 性 的 有 效 取 


值 。 


#2D-3: lsolation 枚 举 值 














值 描述 
Isolation.DEFAULT 使 用 底层 数据 库 的 默认 隔离 级 别 
Isolation.SERIALIZABLE 提供 最 高 级 别 的 隔离 级 别 ， 不 能 读 取 “ 脏 ”数据 ， 不 能 


重复 读 取 ， 也 不 能 约 像 读 取 (phantom read)。 当 使 用 这 
种 隔离 级 别 时 ， 即 使 读 操 作 也 需要 获得 锁 。 在 使 用 这 种 
隔离 级 别 〈 包 括 高 于 READ_UNCOMMITTED 以 上 的 隔 
离 级 别 ) 时 ， 应 该 小 心 避免 两 个 活动 事务 之 间 的 死 锁 
(deadlock) 冲突 

Isolation.REPEATABLE_READ 不 能 读 取 “ 脏 ” 数 据 和 重复 读 取 。 但 可 能 幻 读 

Isolation.READ_COMMITTED 不 能 读 取 “ 脏 ” 数 据 。 但 可 能 重复 恋 和 幻 读 

Isolation.READ_UNCOMMITTED 最 低级 别 的 隔离 级 别 ， 一 个 事务 可 以 看 到 另 一 个 事务 未 
提交 的 修改 。 脏 读 、 重 复读 以 及 幻 读 在 这 个 级 别 内 都 有 


可 能 发 生 





在 真实 世界 的 系统 中 使 用 SERIALIZABLE 隔 离 级 别 也 经 常 是 不 现实 
的 ， 因 为 对 数据 库 的 访问 不 会 全 部 都 “顺序 依次 ”发 生 。 通 常 使 用 的 是 
REPEATABLE_READ 或 READ_COMMITTED 隔 离 级 别 ， 并 构建 一 些 检 
测 死 锁 和 在 失败 后 尝试 重新 操作 的 逻辑 代码 。 大 型 多 用 户 应 用 程序 〈 例 
如 Web 网 站 ) 在 使 用 SERIALIZABLE 时 需要 当心 事务 死 锁 ， 如 果 使 用 的 
是 高 于 READ_UNCOMMITTED 的 任何 级 别 ， 就 应 该 确保 在 Transactional 
标注 中 为 timeout 属 性 定义 了 一 个 有 限 的 超时 时 间 值 。 事 务 隔离 的 具体 行 
为 会 依赖 于 正在 使 用 的 数据 库 ， 例 如 ，MySQL 的 InnoDB 存 储 引 擎 对 事 
务 隔离 级 别 的 解释 就 与 Oracle、SQL Server、Derby 或 HSQLDB 中 的 版 本 
存在 一 些 差异 。 





使 用 JTA 事 务 管理 器 


在 第 13 章 的 示例 中 ， 我 们 使 用 的 是 HibernateTransactionManager， 
因为 它 用 起 来 比较 直观 和 简单 。 如 果 需 要 使 用 JTA 来 参与 分 布 式 事务 ， 
或 者 处 理 跨越 多 种 技术 (JDBC+JMS) 的 事务 ， 那 么 在 
applicationContext.xml 中 可 以 用 其 他 东西 来 取代 transactionManager， 如 
例 D-2 所 示 。 








例 D-2: 配置 JTA 事 务 管理 器 














<! --enable the configuration of transactional behavior based on 
annotations--> 

<tx:annotation-driven transaction-manager="transactionManager"/> 

<bean id="transactionManager" 

class="org.springframework.transaction.jta.JtaTransactionManager"/ 














> 


附录 E 参考 资源 


为 了 更 深入 地 挖掘 Hibernate 的 能 力 ， 以 及 使 用 它 的 其 他 方法 ， 还 有 
许多 研究 学 习 的 渠道 。 以 下 就 介绍 一 些 好 的 习 学 资源 ， 挑 选 些 最 适合 你 
需要 的 方法 ， 确 定好 你 的 学 习 风 格 和 时 间 安 排 。 


在 线 手册 


本 书 中 涉及 的 开发 工具 部 提供 了 不 错 的 在 线 文 档 。 如 果 你 想 了 解 一 
下 这 些 开 发 包 的 基本 用 法 ， 在 线 参考 手册 可 以 给 你 提供 有 关 如 何 完成 特 
定 任务 的 详细 介绍 。 在 每 个 开发 包 主页 的 显 音 位 置 上 都 可 以 找到 


Documentation 链 接 。 





图 书 


由 Christian Bauer 和 Gavin King 编 著 的 《Java Persistence with 
Hibernate) (Manning Publications) 更 加 完整 而 详细 地 讨论 了 
Hibernate。 这 两 位 专家 作为 Hibernate 的 创作 者 ， 他 们 非常 熟悉 Hibernate 
的 细节 ， 不 过 有 时 也 运用 了 些 相当 深奥 的 专业 的 数据 库 概 念 。 





为 了 掌握 些 专业 知识 ， 你 也 可 以 阅读 一 下 George Reese 写 的 《Java 
Database Best Practices) (O'Reilly) ， 或 者 至 少 读 一 下 我 们 在 本 书 第 4 
章 中 提 到 的 相关 章节 〈 有 在 线 文 档 可 用 ) H). ERAR Apache 
Maven 的 使 用 ， 可 以 阅读 来 自 Sonatype 的 《Maven: The Definitive 
Guide》。 为 了 更 多 地 了 解 Apache Ant， 可 以 看 看 Jesse E.Tilly 和 Eric 
M.Burke 写 的 《Ant: The Definitive Guide) (O'Reilly) (1) ， 或 者 





是 读 一 下 最 近 由 Steve Loughran 和 Erik Hatcher 写 的 《Ant in Action) 


(Manning) 。 


有 关 Spring Framework 的 更 多 信息 ， 可 以 选择 参考 由 Bruce Tate 和 
Justin Gehtland 写 的 《Spring: A Developer's Notebook) (O'Reilly) ， 或 
者 是 参考 由 Rod Johnson. Juergen Hoeller、Alef Arendsen、Thomas 
Risberg 以 及 Colin Samplaneau 4H) (Professional Java Development with 
the Spring Framework) (WROX) 。 虽 然 本 书 的 作者 们 可 能 倾向 于 多 推 
荐 OReilly 的 书目 ， 不 过 WROX 的 那 本 书 是 由 创建 和 维护 Spring 


Framework 的 那 帮 人 编写 的 。 


源 代码 


和 任何 开源 项 目 一 样 ， 最 终 真正 的 主宰 者 还 是 源 代码 。 通 过 阅读 源 
代码 可 以 学 到 不 少 东 西 ， 而 不 仅仅 是 你 直接 关注 的 任务 。 当 然 ， 作 为 
Java 开 发 包 ， 根 据 源 代码 生成 的 JavaDoc 也 具有 相当 的 参考 价值 。 如 果 
你 在 用 Eclipse， 就 可 以 下 载 项 目的 源 代 码 发 布 版 本 ， 再 告诉 Eclipse 每 个 
JAR 库 的 源 代码 目录 树 在 什么 地 方 。 这 样 做 的 价值 是 ， 在 编写 完成 类 、 
方法 名 称 、 参 数 时 ，Eclipse 会 提示 完整 的 JavaDoc 信 息 ， 通 过 F3 快 捷 键 
也 可 以 打开 每 个 程序 元 素 的 源 代 码 ， 就 好 像 这 些 开 源 代 码 是 你 自己 的 项 
目 一 样 。 我 们 发 现 这 是 一 种 非常 具有 方向 性 和 辅助 学 习 的 好 办 法 。 




















如 果 使 用 Maven， 并 运行 eclipse: _ eclipse 构建 目标 ， 则 可 以 通过 以 
下 命令 来 下 载 源 代 码 和 JavaDoc: 


mvn eclipse: eclipse-DdownloadSources=true 
-DdownloadJavadocs=true 








下 载 每 个 依赖 的 所 有 源 代 码 和 JavaDoc 包 可 能 需要 花费 不 少时 间 。 
在 本 地 Maven 仓 库 下 载 好 源 代码 和 JavaDoc 以 后 ， 就 可 以 在 Eclipse IDE 中 
查看 依赖 库 的 源 代码 和 JavaDoc 了。 目前 广泛 使 用 的 开源 开发 库 的 绝 大 
部 分 (但 并 非 全 部 〉 都 提供 了 源 代码 和 JavaDoc 工 件 。 


处 理 更 新 版 本 的 工具 包 





对 于 印刷 出 版 的 图 书 来 说 ， 软 件 的 不 断 变 化 总 是 个 问题 。 因 此 ， 妆 
你 在 使 用 本 书 涉及 的 所 有 这 些 软件 的 新 版 本 时 ， 可 能 会 遇 到 些 麻烦 。 这 
本 书 的 新 版 所 讨论 的 示例 基于 以 下 特定 版 本 的 各 种 工具 : 





Ant 1.7.0〈 有 时 会 遇 到 麻烦 ) 

Eclipse 3. 3.1.1 

Geronimo JTA 1. 1 implementation 
Hibernate 3. 2.5 

Hibernate Annotations 3. 3.0.ga 

Hibernate Commons Annotations 3. 3.0.ga 
Hibernate Tools 3. 2.0 beta 9a〈 很 多 地 方 ) 
Hibernate Tools 3. 2.0.GA (25115 ) 
HSQLDB 1. 8.0.7 


Log4J 1. 2.14《〈 一 般 不 会 出 现 问题 ) 


Maven 2. 0.8 


MySQL 5. 0.21 


Spring Framework 2.5 


Stripes 1. 4.3 





有 些 工 具 的 更 新 版 本 可 能 会 改变 它们 的 工作 方式 ， 而 且 这 些 变 化 有 
时 还 是 向 后 不 兼容 的 。 这 也 是 跟 上 开源 项 目 发 展 而 市 来 的 部 分 乐趣 。 我 
们 提供 的 Maven 规 则 应 该 可 以 帮助 你 找到 我 们 要 使 用 的 工具 的 特定 版 
本 ， 这 样 会 对 你 的 学 习 和 试验 过 程 有 一 定 帮 助 。 你 也 可 以 检查 这 些 工具 
包 的 发 行 说 明 ， 以 决定 在 什么 时 候 和 如 何 移 植 到 最 新 、 功 能 最 强大 的 版 
本 。 





你 还 可 以 在 本 书 网 站 〈D ) 的 勘误 页 面 上 看 看 是 否 也 有 其 他 人 遇 
到 了 与 你 同样 的 问题 ， 或 许 会 找到 解决 的 办 法 。 如 宁 没 有 ， 也 请 你 尽 
能 提交 目 己 的 发 现 ， 与 别人 一 起 分 诗 ! 





Hibernate 和 HSQLDB 都 有 各 自 的 在 线 支持 论坛 ， 为 应 付 各 种 不 兼容 
的 变化 提供 了 不 少 有 价值 的 建议 ， 也 可 以 学 到 这 些 工 具 其 他 方面 更 为 复 
杂 的 东西 。 


重 在 参与 





开放 源 代码 带 来 的 最 好 的 一 件 事情 就 是 你 不 仅 可 以 使 用 软件 ， 还 可 
以 参与 到 开发 社区 中 来 。 如 果 你 使 用 Hibernate、Spring、Ant、Maven 或 
者 Stripes， 那 么 应 该 订阅 它们 的 用 户 邮件 列表 ， 以 保持 不 断 了 解 其 更 新 
和 新 版 本 情况 。 如 果 你 需要 对 源 代码 进行 定制 ， 最 好 将 你 的 修改 贡献 出 
来 ， 所 有 这 些 项 目 都 有 非常 成 熟 的 开发 社区 ， 以 便 集 成 你 对 代码 所 做 的 
修改 。 在 对 技术 掌握 精深 以 后 ， 可 以 发 挥 一 下 主观 精神 ， 为 开发 人 员 的 
邮件 列表 贡献 一 些 文档 补丁 。 不 必 对 参与 有 所 顾虑 ; 只 有 每 个 人 都 发 挥 
主观 能 动 性 ， 开 源 事业 才 会 匣 壮 成 长 。 在 为 这 些 项 目 做 贡献 时 ， 你 不 必 
向 任何 人 申请 许可 ， 所 有 你 需要 做 的 就 是 鼓 起 勇气 、 开 始 参与 。 





要 了 解 有 关 Hibernate 社 区 的 更 多 详情 ， 并 着 手 参与 这 一 项 目 ， 可 以 
访问 Hibernate 的 官方 网 站 http:/www.hibernate.org。 你 可 以 订阅 为 用 户 和 
开发 人 员 提 供 的 Hibernate 邮 件 列表 ， 或 者 是 按照 主页 上 的 提示 来 看 看 它 
的 支持 论坛 : http:/www.hibernate.org/20.html。Hibernate 团 队 的 博客 也 
非常 活跃 ， 其 网 址 是 http://blog.hibernate.org/。 将 这 个 博客 添加 到 你 的 
RSS 阅 读 器 中 ， 用 这 个 好 办 法 可 以 与 相关 的 技术 保持 同步 (例如 ，Seam 
和 Hibernate Shards) ，Gavin 和 其 他 人 在 这 方面 的 开发 都 很 活跃 。 





Spring Framework 与 一 个 叫做 Spring 


Source (http://www.springsource.com) 的 公司 有 关系 ， 这 个 公司 雇用 了 


很 多 志愿 者 为 Spring 项 目 做 贡献。 有 关 Spring Framework 社 区 的 更 多 信 
息 ， 可 以 访问 http:/www.springframework.org。 如 果 你 想 订 阅 邮 件 列表 
或 者 为 Spring Framework 页 献 源 代码 ， 则 应 该 看 看 开发 页 面 上 的 信息 ， 
网 址 是 http:/www.springframework.org/development。 如 果 你 真 的 对 
Spring Framework 怀 有 激情 ， 那 么 应 该 考虑 参加 Spring Source 的 年 度 会 
i: The Spring Experience。 有 关 Spring 培 训 的 信息 可 以 在 Spring Source 
公司 的 网 站 上 找到 ， 有 关 The Spring Experience 的 信息 则 可 以 访问 该 会 


议 的 网 站 http:/www.thespringexperience.comy/。 


Apache Ant 和 Apache Maven 是 Apache Software Foundation (ASF) 
的 两 个 顶级 项 目 (top-level project) 。Apache Software Foundation 是 一 
个 大 型 的 开发 人 员 社 区 ， 相 关 信 息 可 以 访问 其 官方 网 站 
http:/www.apache.org。Apache 这 个 大 型 组 织 负责 维护 一 些 世 界 上 使 用 
最 广泛 的 项 目 ， 例 如 经 常 使 用 的 Apache Web 服 务 器 和 Tomcat 应 用 程序 
服务 器 ， 以 及 Jakarta Commons 开 发 库 。 有 关 Apache Maven 开 发 社区 的 
详情 ， 可 以 访问 其 项 目 网 站 http://maven.apache.org。 有 关 Apache Ant 开 
发 社区 的 更 多 详情 ， 也 可 以 访问 Ant 的 项 目 网 站 http://ant.apache.org。 
Ant 和 Maven 都 是 非常 活跃 的 社区 ， 其 用 户 和 开发 人 员 的 邮件 列表 的 信 
轧 量 都 非常 大 。 





Stripes 的 主页 是 http://www.stripesframework.org， 在 这 个 网 站 上 可 以 
找到 相关 的 教程 、 参 考 文档 以 及 JavaDoc。 要 订阅 这 个 项 目 在 


SourceForge 上 的 邮件 列表 ， 可 以 访问 https://source-forge.net/mail/? 
group_id=145476。 对 于 那些 Java 语 言 的 极 客 (geek) 来 说 ， 浏 览 Stripes 
的 源 代码 应 该 是 种 有 趣 的 体验 ， 因 为 这 个 项 目的 开发 者 们 显然 精通 并 使 
用 了 目前 Java 的 最 新 功能 。 我 强烈 推荐 下 载 Stripes 的 源 代码 包 ， 随 意 看 
看 ， 权 当 只 是 为 了 兴趣 而 已 。 





[1] http://www.oreilly.com/catalog/javadtabp/chapter/ch02.pdf. 
[2] http://www.sonatype.com/book/index.html. 


[3] http://www.oreilly.com/catalog/9780596517724/. 


作者 简介 


James Elliott 是 Berbee 公 司 的 一 位 资深 软件 工程 师 ， 有 近 20 年 的 系统 
开发 专业 经 验 。 他 对 计算 机 的 专注 和 激情 早 在 职业 生涯 之 前 就 已 经 显 
现 ， 当 他 在 Mexico City 上 中 学 时 就 得 到 了 一 台 标 着 "Apple I1" 的 古怪 设 
备 ， 从 此 残 开 始 了 在 计算 机 领域 的 驰 怠 。 


在 工作 环境 尚未 十 分 方便 之 前 ，Jim 就 已 经 开始 了 面向 对 象 的 开 
发 。 他 热 囊 于 建造 高 质量 的 工具 和 框架 来 简化 其 他 开发 人 员 而 不 只 是 
他 自己 ) 的 工作 ， 豆 欢 研 究 如 何 有 效 地 使 用 Java 才 能 有 助 于 解决 实际 问 
题 ， 尤 其 是 当 这 一 语言 趋 于 成 熟 以 后 。 

















在 经 历 了 环 游 世 界 般 的 童年 时 代 以 后 ，Jim 在 位 于 纽约 州 的 
Rensselaer Polytechnic Institute 大 学 取得 了 学 士 学 位 ， 在 University of 
Wisconsin-Madison 取 得 了 硕士 学 位 ， 在 那 期 间 ， 他 也 在 贝尔 实验 室 ( 位 
于 Murray Hill, C 语 言 和 UNIX 的 诞生 地 ) 从 事 一 些 有 趣 的 工作 。 虽 然 在 
通过 博士 资格 考试 以 后 ，Jim 马 上 欣然 接受 了 现实 世界 的 诱惑 ， 但 是 能 
在 Madison 找 到 有 趣 的 工作 让 他 很 高 兴 。 他 目前 和 他 的 搭档 Joe Buberger 
住 在 Madison。 

















Ryan Fowler 是 Berbee 公 司 的 一 位 软件 工程 师 。 他 的 编程 生涯 开始 于 
Apple I 机 器 上 的 BASIC 语 言 ， 那 时 他 还 在 Michigan 州 Grand Rapids) 


St.Stephen School 恋 小 学 。 一 段 时 间 后 ， 他 又 回 到 Michigan 州 Alma 的 
Alma College 计 算 机 科学 系 写 代码 ， 并 取得 了 学 士 学 位 。Ryan 喜 欢 滑 
雪 、 航 海 ， 有 时 ， 也 弹 弹 吉他 来 打发 时 间 。Ryan 和 他 的 妻子 居住 在 
Wisconsin 的 Madison。Tim O'Brien 是 一 位 Emacs 信徒 ， 最 近 又 转向 了 
Apple Macintosh 计 算 机 。Tim 早 在 20 世 纪 80 年 代 初 就 开始 在 TRS-80 上 编 
写 程序 ， 后 来 在 University of Virginia 学 习 电 子 工程 。 作 为 独立 的 技术 人 
员 ，Tim 经 常 与 Grassroots Technologies 合 作 ; 他 最 近 开 发 了 一 种 混搭 体 
系 结构 ， 可 以 为 金融 信息 、 客 户 保护 、 汽 车 以 及 教育 出 版 业 的 各 种 客户 
端 提供 服务 。 在 闲暇 时 间 ，Tim 喜 欢 睡 觉 、 写 作 以 及 参与 开源 文档 项 
目 。Tim 目 前 和 妻子 Susan、 女 儿 Josephine 居 住 在 Ilinois 的 Evanston 。 





封面 介绍 


本 书 封面 上 的 动物 叫做 刺 狂 (hedgehog) ， 是 一 种 刺 狂 亚 科 
(Erinaceinae) 小 动物 。 目 前 已 经 发 现 了 5 属 16 种 刺 狂 ， 广 泛 分 布 在 欧 
洲 、 亚 洲 、 非 洲 和 新 西 兰 。 其 中 包括 : 四 趾 刺 独 (非洲 撤 哈 拉 以 南 〉、 
KEA CHE) 、 沙 漠 刺 狂 《〈《 亚 洲 和 中 东 ) 、 光 腹 刺 狂 〈 印 度 ) 。 不 
同类 的 刺 狂 体型 大 小 各 不 相同 ， 一 般 长 5 到 12 英 寸 ， 重 15 到 40 番 司 。 作 
为 驯养 的 刺 狂 通常 是 四 趾 刺 狂 或 非洲 侏儒 刺 狂 ， 个 头 比 它们 的 欧洲 同类 
要 小 很 多 ， 目 前 已 经 在 很 多 国家 成 为 流行 的 宠物 。 刺 独 一 词 最 早出 现 于 
15tt 2c “hedge (MT) *, 因为 它 的 根 长 在 地 下 ; "hog" Cf 
JE) 则 是 因为 它 长 着 像 猪 一 样 的 口臭。 刺 猎 的 其 他 名 称 还 有 urchin、 
hedgepig fllfueze-pig. 
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全 号 都 长 满 了 刺 。 当 受到 惊吓 时 ， 它 会 卷 缩 成 球状 ， 全 身 环 刺 竖立 ， 让 
入 侵 者 无 从 下 手 。 这 些 刺 坚硬 而 中 空 ， 由 角质 层 发 育 而 成 ， 非 党 坚固 。 
与 肾 猪 的 刺 不 同 ， 刺 狂 的 刺 不 能 脱落 ， 除 非 在 称 为 " 蚁 皮 ” 的 过 程 中 它 的 
体 刺 才 会 脱落 。 





刺 狂 的 主要 食物 是 一 些小 型 无 葫 椎 动物 ， 例 如 青蛙 、 毛 毛虫 以 及 旺 
晴 。 一 些 刺 狂 能 够 抵抗 许多 毒 系 ， 所 以 它们 可 以 吃 蜜 蜂 、 黄 蜂 甚至 是 毒 
蛇 。 刺 狂 是 在 夜间 活动 的 动物 ， 而 白天 舱 在 草丛 中 岩石 下 面 或 地 洞 中 睡 








大 和 党。 尽管 所 有 的 刺 猜 都 可 以 冬眠 ， 但 也 不 总 是 这 样 ， 因 为 冬眠 要 由 各 
种 因素 来 决定 ， 比 如 地 上 点、 温度 以 及 食物 的 充足 程度 。 在 英国 ， 每 年 11 
月 5 日 的 焰火 之 夜 〈《Bonfire Night) 的 庆祝 会 给 刺 狂 带 来 很 大 的 危险 ， 因 
为 这 些小 动物 经 各 会 畴 在 用 于 燃放 敌 火 的 木料 扒 中 睡觉 。 野 生动 物 保护 
组 织 癌 公众 警告 ， 为 了 保护 正在 冬眠 的 刺 猜 ， 在 点 火 以 前 一 定 要 检查 一 
下 他 们 的 木料 扒 中 是 否 有 这 些 可 爱 的 小 动物 。 








封面 图 片 来 自 于 J.G.Wood 的 Animate Creation. 


